home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 36 / dvtree23.zip / DVTREE.DOC < prev    next >
Text File  |  1991-08-28  |  193KB  |  4,235 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                          ============================
  26.                          DV Tree - The DESQview Shell
  27.                                  Version 2.1
  28.                          ============================
  29.  
  30.  
  31.                 DV Tree - DOS Simplicity Through DESQview Power
  32.  
  33.                            Copyright (c) 1990, 1991
  34.                               Michael D. Weaver
  35.                                 P.O. Box 4323
  36.                         Danville, Virginia 24540-0106
  37.  
  38.  
  39.         DV Tree was written using Turbo C Professional (Borland International).
  40. DESQview interface functions are courtesy of Ralf Brown and his DVGLUE API
  41. library.  Credit also goes to Robert Jourdain for his C Express Programmer's
  42. Library (1989, Simon & Schuster).
  43.     DESQview is a trademark of Quarterdeck Office Systems.
  44.         DVTREE.EXE and all supporting materials are (c)1990-91 Michael D.
  45. Weaver.  All rights are reserved.
  46.  
  47.  
  48.  
  49.                                  page -ii-
  50.  
  51.  
  52.                              Table of Contents
  53.                              -----------------
  54.  
  55.      Introductory Sections
  56.      ---------------------
  57.              Introduction  ......................................   1
  58.              Disclaimer  ........................................   1
  59.              A Note for the Impatient  ..........................   1
  60.              About Shareware  ...................................   2
  61.              System Requirements  ...............................   3
  62.              Notational Conventions  ............................   4
  63.              Definitions  .......................................   5
  64.  
  65.  
  66.      Basic Program Usage
  67.      -------------------
  68.              Getting Started  ...................................   6
  69.                   Quiting DV Tree  ..............................   6
  70.              Basic Operation  ...................................   6
  71.                   Marking files  ................................   6
  72.                   Explanation of @ 1024  ........................   7
  73.                   The Mas(K) command  ...........................   7
  74.                   The Dynamic Wildcard Feature  .................   7
  75.                   The @ (ALT) key command variation  ............   8
  76.                   The (U)nmark command  .........................   8
  77.                   Error/Informational message displays  .........   8
  78.                   Using Sub-Menus  ..............................   8
  79.                   The ESC key  ..................................   9
  80.              Using A Mouse  .....................................   9
  81.              Manipulating the Display  ..........................   9
  82.                   The TAB key  ..................................   9
  83.                   The / key (initiating split screen)  ..........  10
  84.                   Flipping the split screen display  ............  10
  85.                   Exiting split screen  .........................  10
  86.              Controlling the File Display  ......................  11
  87.                   PageUP/PageDN  ................................  11
  88.                   ^PageUP/^PageDN  ..............................  11
  89.                   ^Home  ........................................  11
  90.                   The = (Jump) command  .........................  11
  91.                   The Backspace ('next' Jump) command  ..........  11
  92.                   Home/End  .....................................  12
  93.                   (I)ncl/@(I)ncl  ...............................  12
  94.                   E(X)clude  ....................................  12
  95.                   ^R (the directory 'reread' command)  ..........  12
  96.                   (S)ort  .......................................  12
  97.                   @(S)ort (the two-level sort command)  .........  13
  98.              DV Tree's Command History Feature  .................  13
  99.              Navigating Drives and Directories  .................  14
  100.                   The (T)ree command  ...........................  14
  101.                   Paging and positioning commands  ..............  14
  102.                   The > command (main and tree)  ................  15
  103.  
  104.  
  105.  
  106.                                  page -iii-
  107.  
  108.                   (S)witch  .....................................  15
  109.                   Escape  .......................................  16
  110.                   Summary of other ways to change directories ...  16
  111.              File Management Commands  ..........................  16
  112.                   (D)elete  .....................................  16
  113.                   (C)opy  .......................................  17
  114.                   (M)ove  .......................................  18
  115.                   (R)ename  .....................................  18
  116.                   (A)ttr  .......................................  18
  117.                   @(C)opy  (or 'Alternate Copy')  ...............  19
  118.                       Create (Clone)  ...........................  19
  119.                       Append to File  ...........................  19
  120.              The Find Command  ..................................  19
  121.                   (F)ind/@(F)ind  ...............................  19
  122.                   Example uses of the (F)ind command  ...........  21
  123.                   -  (the minus key, aka the (F)ind toggle)  ....  21
  124.                   @= (the (F)ind 'jump' command)  ...............  21
  125.                   A technique for (F)ind on multiple drives  ....  22
  126.              Exploiting the Split Screen Feature  ...............  22
  127.                   The TAB key in split screen copy/move  ........  23
  128.                   [-M     (Split menu-Match Identical)  .........  23
  129.                   [-N     (Split menu-Name Only)  ...............  23
  130.                   [-T     (Split menu-Tag Newer)  ...............  23
  131.                   [-L     (Split menu-Lock Toggle)  .............  24
  132.              ^\ - The 'Temporary' Directory Command  ............  25
  133.              Managing Trees  ....................................  26
  134.                   (A)dd  ........................................  26
  135.                   (D)el  ........................................  26
  136.                   (R)ename  .....................................  26
  137.                   Re(B)uild  ....................................  26
  138.                   (M)ove  .......................................  26
  139.                   (K)lip  .......................................  27
  140.                   + (The 'Klip' toggle) .........................  27
  141.                   (U)nklip  .....................................  27
  142.  
  143.  
  144.      DESQview Specific Features
  145.      --------------------------
  146.              DV Tree's (E)xec Command  ..........................  28
  147.                   (E)xec  .......................................  28
  148.                   @(E)xec  ......................................  29
  149.              (P)rint - A File-Oriented 'Mark and Transfer'  .....  29
  150.                   (P)rint/@(P)rint  .............................  29
  151.              Introduction to DESQview Functions  ................  30
  152.                   A tutorial with LIST  .........................  30
  153.              Running DV Tree in a Small Window   ................  36
  154.                   @ESC  .........................................  36
  155.              Setting up a Help System for DV Tree  ..............  37
  156.                   A note about scripts  .........................  38
  157.              More Fun with DESQview Functions  ..................  38
  158.                   A little philosophy   .........................  38
  159.                   Sample 'real world' strings  ..................  40
  160.  
  161.  
  162.  
  163.                                  page -iv-
  164.  
  165.                   Two examples with PKZIP  ......................  41
  166.                   A variation on (E)xec .........................  42
  167.                   Using LIST as a text scan utility  ............  43
  168.                   Creating a 'slave' DOS window  ................  44
  169.                   A DOS XCOPY window  ...........................  44
  170.              Miscellaneous DESQview Functions Features ..........  45
  171.                   User macro strings  ...........................  45
  172.                   Cloning code strings  .........................  45
  173.                   Title Edit  ...................................  46
  174.                   Open Keys Change  .............................  47
  175.              Using .EXT Files ...................................  47
  176.  
  177.  
  178.      DV Tree Customization
  179.      ---------------------
  180.              Configuration        (Zpecial Menu) ................  48
  181.                   DESQ Directory  ...............................  48
  182.                   .DVP Directory  ...............................  48
  183.                   File # Max  ...................................  48
  184.                   Tree Size Max  ................................  48
  185.                   Exec K Addition  ..............................  48
  186.                   Minimum Exec K  ...............................  49
  187.                   Restore Defaults  .............................  49
  188.              Color Customization  (Zpecial Menu)  ...............  49
  189.                   Method 1:  (Uses own colors = N)  .............  49
  190.                   Method 2:  (A)djust Colors  ...................  49
  191.                   DESQview and color  ...........................  50
  192.              The Configurable Toggles  ..........................  50
  193.                   ^A  (Auto Refresh)  ...........................  51
  194.                   ^C  (Auto Split Copy)  ........................  51
  195.                   ^F  (Field Marks)  ............................  51
  196.                   ^T  (Tree Sorts)  .............................  51
  197.                   ^D  (Directory Entries)  ......................  51
  198.                   ^E  (Expert Keys)  ............................  52
  199.                   ^Q  (Quik Floppies)  ..........................  52
  200.              Globals Save/View    (Zpecial Menu)  ...............  53
  201.              The Directory Hot-Key Feature  .....................  53
  202.                   Setting up numeric hot-keys  ..................  53
  203.                   ^Left/^Right  .................................  54
  204.              Directory Customization  ...........................  54
  205.                   + (plus) customization toggle  ................  55
  206.              Command Line Options  ..............................  55
  207.                   TREE=d:\fspec\filename  .......................  55
  208.                   FMAX=nnn  .....................................  55
  209.                   TMAX=nnn  .....................................  55
  210.                   RESET  ........................................  55
  211.                   EXEC=S / EXEC=E  ..............................  56
  212.                   OPP=d:\filespec  ..............................  56
  213.                   Controlling DV Tree's startup directory  ......  56
  214.                   DISP=n  .......................................  56
  215.                   NOHOP  ........................................  56
  216.                   TROOT  ........................................  56
  217.  
  218.  
  219.  
  220.                                  page -v-
  221.  
  222.              Running DV Tree in EGA/VGA Hi-Res modes  ...........  57
  223.              Running DV Tree from DOS  ..........................  57
  224.                   The TREE= Environment Variable  ...............  57
  225.                   @(Q)uit  ......................................  57
  226.              Performance Notes  .................................  58
  227.              Network Usage Notes  ...............................  58
  228.  
  229.  
  230.      Appendix A:  DESQview Function Codes Reference
  231.      ----------------------------------------------
  232.              Major Codes  .......................................  59
  233.              String Replacement Codes  ..........................  60
  234.              Special String Replacement Codes  ..................  61
  235.              'PIF' Directory Codes  .............................  61
  236.              Special Keystroke Codes  ...........................  62
  237.              Script Initiation Codes  ...........................  62
  238.              Delay Codes  .......................................  63
  239.              Special Action Codes  ..............................  63
  240.              'Hidden' DESQview Feature Codes  ...................  67
  241.  
  242.  
  243.      Appendix B:  Files Created and Used by DV Tree  ............  68
  244.      Appendix C:  Error Messages produced by DV Tree ............  69
  245.      Appendix D:  Script Ideas for DV Tree  .....................  71
  246.  
  247.  
  248.  
  249.                                      Part 1:
  250.                               Introductory Sections
  251.                               ---------------------
  252.  
  253.  
  254.      ┌────────────────┐
  255.      │  INTRODUCTION  │
  256.      └────────────────┘
  257.  
  258.              DV Tree is a small but very powerful file manager/shell for the
  259.      DESQview multi-tasking environment.  By exploiting DESQview's API, the
  260.      program provides many features for DESQview users unavailable in other
  261.      products, even the most expensive commercial file managers. And although
  262.      DV Tree is packed with file management features designed to compete with
  263.      the best alternatives in the 'plain DOS' world, it owes its existence to
  264.      its DESQview specific functions.
  265.  
  266.              This document functions both as a plain English user's guide and a
  267.      tutorial.  Users who approach it as a tutorial and experiment when
  268.      directed should, when finished, have a good grasp of DV Tree's obvious and
  269.      potential uses.
  270.  
  271.  
  272.  
  273.  
  274.      ┌──────────────┐
  275.      │  DISCLAIMER  │
  276.      └──────────────┘
  277.  
  278.              DV Tree is distributed AS IS - the author cannot accept
  279.      responsibility for the use or abuse of the program resulting in the loss
  280.      of data or other imaginable damages.  Though the author is dedicated to
  281.      DV Tree's correct operation and the implementation and support of
  282.      enhancements requested by registered users, he's not rich and cannot
  283.      therefore accept legal responsibility for the care and feeding of users'
  284.      hard drives and/or other equipment.
  285.  
  286.              Please don't let this section scare you - it's here because, in
  287.      this land of lawyers, it has to be.
  288.  
  289.  
  290.  
  291.  
  292.      ┌────────────────────────────┐
  293.      │  A NOTE FOR THE IMPATIENT  │
  294.      └────────────────────────────┘
  295.  
  296.              The following sections of this manual should be considered HIGHLY
  297.      recommended, if not required reading:
  298.  
  299.              NOTATIONAL CONVENTIONS          (description of NIOS string)
  300.              GETTING STARTED                 (to learn how to 'quit' DV Tree)
  301.              BASIC OPERATION
  302.              DV TREE'S COMMAND HISTORY FEATURE
  303.  
  304.  
  305.  
  306.                                  page -2-
  307.  
  308.              THE FIND COMMAND
  309.              EXPLOITING THE SPLIT SCREEN FEATURE
  310.              INTRODUCTION TO DESQVIEW FUNCTIONS
  311.              RUNNING DV TREE IN A SMALL WINDOW
  312.              SETTING UP A HELP SYSTEM FOR DV TREE
  313.              COLOR CUSTOMIZATION  (ZPECIAL MENU)
  314.              THE CONFIGURABLE TOGGLES
  315.              THE DIRECTORY HOT-KEY FEATURE
  316.              DIRECTORY CUSTOMIZATION
  317.              COMMAND LINE OPTIONS
  318.  
  319.  
  320.  
  321.  
  322.      ┌───────────────────┐
  323.      │  ABOUT SHAREWARE  │
  324.      └───────────────────┘
  325.  
  326.              DV Tree is distributed as shareware.  What this means is that if
  327.      you find this program useful, you are encouraged to 'register' with the
  328.      author for a nominal fee, in this case, $35.  Registration lets you feel
  329.      good and will also give you the following:
  330.  
  331.              1)  The latest release of DV Tree with no timed delay at program
  332.                  startup.
  333.              2)  A slightly smaller, slightly faster version of the program
  334.                  compiled especially for 286/386 machines and up.
  335.              3)  Influence over potential future enhancements.
  336.  
  337.              Registrants will receive a 3.5" 720k diskette unless 5.25" 360k is
  338.      specifically requested.  Those outside the United States and Canada should
  339.      add $5 to the cost to cover airmail shipping.
  340.              The $35 cost is for a single user license; site/multi-user
  341.      licenses are available at the following discounts*:
  342.  
  343.              2-4   persons/machines:  10% discount per copy of program.
  344.              5-10  persons/machines:  20% discount per copy of program.
  345.              11-up persons/machines:  25% discount per copy of program.
  346.      unlimited license for business:  negotiable - please contact author.
  347.  
  348.              Receivers of site/multi-user licenses will receive a single
  349.      registration disk accompanied by permission to duplicate it the requested
  350.      number of times.
  351.  
  352.              If you use DV Tree a lot you should register, if only to encourage
  353.      the development of more DV-specific software in the future.
  354.              Registrations and all comments/inquiries should be addressed to:
  355.  
  356.              Michael D. Weaver
  357.              Box 4323
  358.              Danville, VA   24540-0106
  359.  
  360.  
  361.  
  362.  
  363.                                  page -3-
  364.  
  365.              Electronic contact addresses:
  366.  
  367.              MCI Mail        (422-7384)
  368.              CIS             (72210,2035)
  369.  
  370.              The shareware archive of this program (DVTREEnn.ZIP) may be freely
  371.      distributed through electronic bulletin board systems or any other means
  372.      as long as all files are included unmodified and no fee in excess of $5 is
  373.      charged the person receiving the program.
  374.  
  375.  
  376.      *  Listed rates, including the $35 single user license, are guaranteed
  377.      through December 31st, 1991, but thereafter subject to change without
  378.      notice.
  379.  
  380.  
  381.  
  382.  
  383.      ┌───────────────────────┐
  384.      │  SYSTEM REQUIREMENTS  │
  385.      └───────────────────────┘
  386.  
  387.              To run this program you will need an IBM or compatible computer
  388.      running DESQview from Quarterdeck Office Systems, version 2.0 or higher.
  389.      To make use of the optional TSR, DVTXDI.COM, which can provide DV Tree
  390.      with information on other applications running within DESQview, you must
  391.      have DESQview 2.26 or higher.
  392.  
  393.              The presence of one or more hard drives is highly recommended,
  394.      and, in fact, assumed in the documentation.
  395.  
  396.              If you have an older XT class machine, or a machine with a
  397.      non-standard keyboard, you may need to be running DESQview 2.23 or later
  398.      (symptom of this requirement:  The keys for half the commands don't work).
  399.  
  400.              For practical purposes, a certain number of DESQview Applications
  401.      are also required to exploit DV Tree's more advanced functions.  When
  402.      referred to in this document, a DESQview Application is a program that has
  403.      an entry on, and may be started from, the main DESQview Open Menu.  DV
  404.      Tree's power and potential is greatly reduced on systems afflicted by the
  405.      'BIG DOS' style of DESQview management, that is, systems with only a
  406.      handful of entries on the 'Open' menu wherein the vast majority of work is
  407.      performed in 'BIG DOS' partitions.  This condition can be handily cured
  408.      through use of DESQview's Add A Program facility.
  409.  
  410.              At the least, we urge you to create Open Menu entries for your
  411.      preferred file listing and editing programs.  As DV Tree is a DESQview
  412.      shell as opposed to an all-purpose, 'this is the only thing you need on
  413.      your system' program, it provides no internal viewing or editing
  414.      functions, even for ASCII files.  You are assumed to have command line
  415.      versions of these types of programs with which you are comfortable.  Once
  416.      these programs, and many others, for that matter, are available on the
  417.  
  418.  
  419.  
  420.                                  page -4-
  421.  
  422.      DESQview Open Menu, DV Tree may quickly be configured to interface with
  423.      them, the end result being a file management system with far greater
  424.      flexibility than other programs with primitive and/or clumsy
  425.      listing/editing functions.
  426.  
  427.              Because of the above, certain levels of DOS, and especially
  428.      DESQview, knowledge will be demanded of you.  Great care has been taken to
  429.      ensure this document is as clear and precise as possible, but as DV Tree
  430.      depends on the presence of DESQview, so does this document depend, in
  431.      parts, on an understanding of the DESQview manual.
  432.  
  433.  
  434.  
  435.  
  436.      ┌──────────────────────────┐
  437.      │  NOTATIONAL CONVENTIONS  │
  438.      └──────────────────────────┘
  439.  
  440.              The following conventions are used throughout this document and
  441.      other documentation for this program:
  442.  
  443.           @  ...preceding a command or key name.  The Alt key should be
  444.              depressed along with the associated key.
  445.  
  446.           ^  ...preceding a command or key name.  The Ctrl key should be
  447.              depressed along with the associated key.
  448.  
  449.          ()  ...around a single character.  Parentheses are used to highlight
  450.              the actual keyboard character required to execute a command.  For
  451.              instance, F will initiate the (F)ind command, while X will
  452.              initiate E(X)clude.
  453.  
  454.        NIOS  ...appearing on the right hand side of the page at the beginning
  455.              of a command description.  This indicates that the main screen or
  456.              tree command does not have a reminder in the DVTREE Option Summary
  457.              area; thus, if you have an ASCII viewing program with text search
  458.              capabilities, you can quickly find descriptions of DV Tree's less
  459.              obvious commands.
  460.  
  461.        N2.1  ...appearing on the right hand side of the page at the beginning
  462.              of a command description or section.  This indicates that the
  463.              feature or command is new to DV Tree Version 2.1.
  464.  
  465.        N2.3  ...appearing on the right hand side of the page at the beginning
  466.              of a command description or section.  This indicates that the
  467.              feature or command is new to DV Tree Version 2.3.  You may also
  468.              see N2.3 (N2.2) - this indicates that the enhancement was actually
  469.              available in version 2.2, but this document wasn't updated until
  470.              2.3.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.                                  page -5-
  478.  
  479.  
  480.      ┌───────────────┐
  481.      │  DEFINITIONS  │
  482.      └───────────────┘
  483.  
  484.      PIF
  485.  
  486.              Program Information File.  With respect to DESQview, PIFs are
  487.      small files, usually 416 bytes long and usually found in the main \DV
  488.      directory, that provide DESQview with the information it needs to initiate
  489.      an application.  Within DESQview, PIFs are added/modified via Add a
  490.      Program and Change a Program.
  491.  
  492.  
  493.      pointed-at file
  494.  
  495.              The 'pointed-at' file refers to the file in DV Tree's display that
  496.      is highlighted by the moving cursor bar.
  497.  
  498.  
  499.      current
  500.  
  501.              As in 'current drive', 'current directory', and 'current display'.
  502.      Current essentially means 'active', or, more directly, what you're looking
  503.      at or acting on.  The current drive is the drive containing the directory
  504.      or the find list in the current display.  The current directory is the
  505.      directory visible in the current display, and the current display is
  506.      either the full display, or the half of a split screen display in which
  507.      you are currently working.
  508.  
  509.  
  510.      abort
  511.  
  512.              'Abort' is standard computer terminology for terminating an
  513.      operation before it has completed.
  514.  
  515.  
  516.  
  517.  
  518.                                       Part 2:
  519.                                 Basic Program Usage
  520.                                 -------------------
  521.  
  522.      ┌───────────────────┐
  523.      │  GETTING STARTED  │
  524.      └───────────────────┘
  525.  
  526.              Complete installation instructions for DV Tree are contained in
  527.      the ASCII file INSTALL.DOC.  If you have not already done so, please
  528.      refer to INSTALL.DOC to install the program before continuing.
  529.  
  530.              Once DV Tree has been successfully installed, selecting TL (DV
  531.      Tree 100k) on DESQview's Open Menu will bring up the program.  If you have
  532.      a shareware copy, the program will present a screen to provide you
  533.      information on how to obtain a registered copy; after a short delay you
  534.      should see the program's main screen.
  535.  
  536.              The major portion of the display shows information on files, while
  537.      the right side of the screen provides a summary of options along with
  538.      system status information such as the number of files in the current
  539.      directory and the number of free bytes on the current drive.  The Option
  540.      Summary, due to space constraints, cannot possibly show all commands
  541.      available in the program.  The most obvious omission is the (Q)uit command
  542.      - if you like, try it now (key 'Q'), then restart DV Tree.  The program
  543.      may also be quit by keying @Q; this method bypasses the quit verification
  544.      prompt.  Still another way of ending the program is via the DESQview
  545.      'Close Window' command.
  546.  
  547.              Now that you've got your feet wet, you might want to change the
  548.      the directory you first see when DV Tree starts up.  To do this, all you
  549.      have to do is put the name of one of your favorite directories in the
  550.      Directory.: field of DV Tree's PIF using Change a Program.
  551.  
  552.  
  553.  
  554.  
  555.      ┌───────────────────┐
  556.      │  BASIC OPERATION  │
  557.      └───────────────────┘
  558.  
  559.              As demonstrated in the previous section with the Q key, many of DV
  560.      Tree's functions are based on single keystroke commands.  In the Option
  561.      summary, the necessary key for a given command shows as a highlighted
  562.      character.
  563.  
  564.              Some commands, like Q, have no relationship to the state of the
  565.      file display, while others are dependent on the position of the cursor
  566.      bar.  For instance, (R)ename and (A)ttr are commands that apply only to
  567.      the file under the cursor bar.  This is known as the 'pointed-at' file.
  568.  
  569.              Other commands, such as (C)opy, (M)ove, and (D)elete, can work on
  570.      groups of files as well as the pointed-at file.  To create a 'group' for
  571.      these commands, you must 'mark' the appropriate file names.  Marks may be
  572.  
  573.  
  574.  
  575.                                  page -7-
  576.  
  577.      toggled on and off for a file with either the Enter key, or the Spacebar.
  578.  
  579.              When files are marked, statistics related to the marked files are
  580.      show in the bottom right hand corner of the display.  These statistics
  581.      include the number of marked files, the total number of bytes in the
  582.      marked files, and a third line labeled '@ 1024'.  This third value is of
  583.      potential significance if you are marking files with the intention of
  584.      copying them to a floppy disk. The reason for this is that files on DOS
  585.      floppy disks are 'blocked' in increments of 1024 bytes, meaning that a
  586.      file with a 'size' of only 10 bytes will actually take up 1024 bytes of
  587.      space on a floppy disk.  The same is true for a hard drive (though the
  588.      blocking factor may be 512, or 2048, rather than 1024), but in practice
  589.      you are much more likely to find yourself trying to cram files onto a
  590.      floppy disk than onto your hard disk, and this third value will tell you
  591.      exactly how much floppy disk space the files will require.
  592.  
  593.              In addition to the Enter key and the Spacebar, there are other
  594.      ways to manage file marking in DV Tree:
  595.  
  596.  
  597.      Mas(K)/@Mas(K)
  598.  
  599.              Mas(K) is a DV Tree command - note how it appears at the left of
  600.      the page; this is a 'standard' for commands throughout this documentation.
  601.      The key to use for the Mas(K) command is K.  When you hit it, you will see
  602.      an input prompt that should be primed with '*.*'.  Mask allows you to
  603.      mark files in a way similar to DOS's own file masking logic - for DV
  604.      Tree's Mas(K) command, you can use the * symbol, but not the ? symbol.  If
  605.      you hit the Enter key  with the mask set to *.*, all the files in the
  606.      display will be marked.
  607.  
  608.              Once you get used to this command, you will find it far superior
  609.      to the standard technique of 'leaning' on the Enter key employed by other
  610.      file managers to mark an entire directory of files in preparation for a
  611.      copy, move, or delete operation.
  612.  
  613.              Another feature of the Mas(K) command is that it uses 'dynamic
  614.      wildcard' logic.  This means that if you enter only 'C' into the input
  615.      prompt, Mas(K) will respond as if you had entered 'C*.*'. If you like, you
  616.      can experiment with this feature.  Note that once you've entered something
  617.      like 'C', the next time you key K for Mas(K), the input prompt will
  618.      already be primed with 'C*.*'.  The reason for this is that the last
  619.      Mas(K) command, like many other commands, is 'remembered' by DV Tree.  To
  620.      get quickly back to '*.*', you can - again by exploiting the 'dynamic
  621.      wildcard' logic - simply enter '*' at the Mas(K) prompt.
  622.  
  623.              Other commands in DV Tree will also dynamically add wildcard
  624.      specifications to your input.  These command include the (F)ind command,
  625.      and the (I)ncl command.  If for any reason you want to defeat this feature
  626.      for any given input, simply make sure that you specify your file mask to
  627.      the qualifying dot (.).  For instance, entering DVTREE at the Mas(K)
  628.  
  629.  
  630.  
  631.                                  page -8-
  632.  
  633.      prompt will cause the program to mark files as if you'd entered DVTREE*.*,
  634.      but entering DVTREE. will only mark a file with exactly that name.
  635.  
  636.              Still another feature of the Mas(K) command is the variation
  637.      produced when you hit the command key (K) in conjunction with the ALT (@)
  638.      key.  In this case, the input prompt is primed with the filename of the
  639.      pointed-at file, minus its extension (rather than the last command
  640.      entered).  Again, several other DV Tree commands (including (F)ind and
  641.      (I)ncl) work in the same way.
  642.  
  643.  
  644.      (U)nmark
  645.  
  646.              (U)nmark is very quick and simple command that will immediately
  647.      'unmark' all of the marked files in the display.  If you haven't marked
  648.      any files, it will, of course, have no effect.
  649.  
  650.  
  651.              From time to time, DV Tree produces error/informational messages
  652.      in a small window in the top left hand corner of the screen.  An example
  653.      of this is when you change one of the configurable toggles - say the ^F
  654.      toggle that toggles on and off Field Marks (the little » character that
  655.      appears next to marked files.)  If you like, you can try this toggle now
  656.      to see the message it produces.  To remove such a message and continue
  657.      work, hit the ESC key.  To toggle Field Marks back on again, hit ^F and
  658.      ESC one more time.  The ^F toggle is covered later in the section THE
  659.      CONFIGURABLE TOGGLES.
  660.  
  661.              Many commands will result in scrolling 'sub-menus'.  To see such a
  662.      menu, key (S)ort.  Choices on these scrolling menus in DV Tree may be made
  663.      in two ways:
  664.  
  665.              1)  By positioning the cursor bar on the desired item and pressing
  666.                  Enter or the Spacebar.
  667.  
  668.              2)  By keying the first letter of the desired choice.  An
  669.                  exception to this occurs when the first character of an item
  670.                  has already occurred 'higher up' in the menu; you can see this
  671.                  on the sort sub-menu in 'Date Only', the fourth item down.
  672.                  In this case, 'D' has already been used for 'Date/Time', so
  673.                  to select 'Date Only', you have to key 'O' (for 'Only' - the
  674.                  second word in the option.)  This sort of situation is rare -
  675.                  the general rule is that the first character of a choice will
  676.                  activate that choice.  The only menu that you MUST use the
  677.                  scrolling cursor bar on is the menu presented when duplicate
  678.                  files are found during copy/move operations.
  679.  
  680.              The 'letter selection' capability of the scrolling menus allows
  681.      you to easily set up DESQview scripts to perform common functions.  For
  682.      instance, if you occasionally like to see the display sorted by name in
  683.      ascending order, but at other times by date/time in descending order, you
  684.      might record the keystrokes necessary to perform each of these sorts on
  685.  
  686.  
  687.  
  688.                                  page -9-
  689.  
  690.      keys not used by DV Tree, say F11 and F12, and then be able to quickly
  691.      flip back and forth between the two sort orders.  If you are not familiar
  692.      with DESQview's Learn feature, refer to your DESQview manual for more
  693.      information.
  694.  
  695.              Another general rule in DV Tree concerns the escape key.  When
  696.      you're presented with any menu, ESC will almost always just make it go
  697.      away.  In this respect, you might think of ESC as a universal 'do-nothing'
  698.      key, and no harm should ever come to your system when you use it.
  699.  
  700.  
  701.  
  702.  
  703.      ┌─────────────────┐
  704.      │  USING A MOUSE  │
  705.      └─────────────────┘
  706.  
  707.              Most, but not all, functions of DV Tree can be accessed by mouse
  708.      users.  On the main and tree displays, the left mouse button functions as
  709.      the Enter key, while the right mouse button will 'pull down' a mouse
  710.      selectable menu.  On the mouse selectable menus, select a choice with the
  711.      left button.  The right button will function both as ESC and PageUp.
  712.  
  713.              On scrolling menus, use the left button to make a selection, and
  714.      the right button as the ESC key.
  715.  
  716.  
  717.  
  718.  
  719.      ┌────────────────────────────┐
  720.      │  MANIPULATING THE DISPLAY  │
  721.      └────────────────────────────┘
  722.  
  723.              DV Tree has several commands to enhance the usefulness of its file
  724.      display.  Try the following:
  725.  
  726.  
  727.      TAB
  728.  
  729.              The TAB key will toggle the file display between three column and
  730.      a single column, maximum file information mode.  If the screen is split
  731.      vertically, it will toggle between the two sides of the split.  The
  732.      description of the TAB key will change accordingly in the Option Summary
  733.      area.
  734.              In the single column mode, DV Tree tells you as much about the
  735.      file as it knows.  This information includes the file size, the file date
  736.      and time, and the file attributes (details on attributes are given later
  737.      in the description of the (A)ttr command.)  In the 3-column mode, DV Tree
  738.      displays only the filename and the file size.
  739.              By default, DV Tree will start with the display in maximum
  740.      information, or 'INFO' mode.  If you find you prefer the 3-column display,
  741.  
  742.  
  743.  
  744.                                  page -10-
  745.  
  746.      you may set this permanently.  How to do this is covered in the section
  747.      titled GLOBALS SAVE/VIEW.
  748.  
  749.  
  750.      /  (the slash key)
  751.  
  752.              The / key initiates split screen or dual directory mode.  The file
  753.      display is divided into two halves which may be positioned independently
  754.      to different drive/directory combinations.  To test this feature, use / to
  755.      split the screen, then bring up the directory tree of your hard drive with
  756.      the T command, and use the cursor keys to select a new directory.  After
  757.      hitting enter, you should see the new directory displayed in one side of
  758.      the split, and the one you started from in the other. Once in split
  759.      screen, the / key will toggle you from one side of the split to the other.
  760.      Also, DV Tree has a group of commands that apply only to split screen
  761.      mode; a selection list for these commands may be accessed via the left
  762.      brace key ([).
  763.  
  764.  
  765.      [-F     (Split menu-Flip Horz/Vert)
  766.  
  767.              By default, the / command splits DV Tree's display vertically.
  768.      For many purposes, this vertical split is the most convenient as it allows
  769.      side by side comparison of two directories, but its major limitation is
  770.      lack of screen space to show all the available information related to
  771.      files shown (note that, in vertical split mode, the TAB key acts like the
  772.      / key, instead of toggling between the 3 column and informational
  773.      displays.)  To compensate, the file display may also be split
  774.      horizontally.  To see this, use the [ key to bring up the special split
  775.      screen menu, and key F to select Flip Horz/Vert (or highlight this entry
  776.      with the cursor bar and press enter).  The screen should 'flip' into
  777.      horizontal split mode, and the TAB key will now act in the same way it
  778.      does on an unsplit display.
  779.  
  780.  
  781.      [-E     (Split menu-End Split)
  782.  
  783.              Use this command to end split screen and return to single
  784.      directory mode.  The 'current' side of the split (the side pointed to by
  785.      an arrow in the dividing bar) will become the current, single directory.
  786.  
  787.              As you may have guessed from the [ menu, split screen mode has
  788.      more uses - these are covered later in a section specifically on
  789.      exploiting the possibilities of using DV Tree in split screen.
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                  page -11-
  797.  
  798.  
  799.      ┌────────────────────────────────┐
  800.      │  CONTROLLING THE FILE DISPLAY  │
  801.      └────────────────────────────────┘
  802.  
  803.              The previous section explained the various ways DV Tree's display
  804.      can be fundamentally changed; this section explains how to view the file
  805.      list itself in different ways.
  806.  
  807.              First, five commands are available for navigating 'multi-page'
  808.      displays:
  809.  
  810.  
  811.      PageUP/PageDN                                               NIOS
  812.  
  813.              Respectively, the paging keys do exactly as you might expect:
  814.      move forward or back by a 'page'.  If DV Tree is running in less than a
  815.      full screen, the paging keys will respond intelligently (i.e. if you've
  816.      shrunk the window to a single column display that shows five files, PageDN
  817.      will show the next five files.  For more, see the section RUNNING DVTREE
  818.      IN A SMALL WINDOW.)
  819.  
  820.  
  821.      ^PageUP/^PageDN                                             NIOS
  822.  
  823.              When used in combination with the CTRL key, the paging keys will
  824.      position respectively to the first or last 'page' of available files.
  825.  
  826.  
  827.      ^Home                                                       NIOS
  828.  
  829.              ^Home is a special, but particularly useful key in some instances.
  830.      This key will cause the display to reposition so that the pointed-at file
  831.      becomes the first file shown.
  832.  
  833.  
  834.      = (Jump)
  835.  
  836.              The = key is another special key for positioning the display. DV
  837.      Tree prompts for input, which should be a 'high level' substring of a
  838.      filename, then attempts to position the display so that the first file
  839.      with a name beginning with the input string becomes the first file in the
  840.      display.  For instance, if you key in 'CON' at the input prompt, the
  841.      display might position with a file named 'CONFIG.SYS' at the top.
  842.  
  843.  
  844.      Backspace ('next' Jump)                                     NIOS  N2.1
  845.  
  846.              The backspace key repeats the effect of the = (Jump) command,
  847.      looking for the next match to input string (as opposed to the first match
  848.      that another use of = would produce.)  Expanding on the example cited for
  849.      the = command, the backspace key might cause the display to move down from
  850.  
  851.  
  852.  
  853.                                  page -12-
  854.  
  855.      'CONFIG.SYS' being the first file shown, to 'CONTROL.FIL' being the first
  856.      shown.
  857.  
  858.  
  859.              The following two command are related to the above group, but they
  860.      affect only the position of the cursor bar:
  861.  
  862.      Home/End                                                    NIOS
  863.  
  864.              The Home key will cause the cursor bar to be positioned
  865.      immediately over the first file visible in the display.  End does just the
  866.      opposite, positioning the cursor bar to the last file.
  867.  
  868.  
  869.              Another set of main screen commands can also affect how you see
  870.      the files displayed; experiment with the following:
  871.  
  872.  
  873.      (I)ncl/@(I)ncl
  874.  
  875.              This command affects how the directory information is obtained
  876.      from your disk.  (I)ncl asks you to input a file mask, and the current
  877.      directory is reread according to the mask, i.e., a mask of *.BAT will
  878.      cause the file display to show only those files with an extension of 'BAT'
  879.      (just like DIR *.BAT from the DOS command line.)
  880.              The (I)ncl command supports the dynamic wildcard feature, and if
  881.      hit in conjunction with ALT key, the input prompt will be primed with
  882.      the filename minus the extension of the pointed-at file.
  883.  
  884.  
  885.      E(X)clude
  886.  
  887.              This command allows you to quickly cull unwanted or distracting
  888.      entries from a file display.  Either the marked, or the unmarked entries
  889.      can be put 'out of sight' by selecting the appropriate entry on the
  890.      scrolling menu produced when this command is used.
  891.  
  892.  
  893.      ^R                                                          NIOS
  894.  
  895.              The ^R command provides a quick way to reread the directory
  896.      information from disk (or repeat a FIND operation - covered later in THE
  897.      FIND COMMAND.)  All file marks will be lost, and any 'culling' of the
  898.      file list through use of the E(X)clude command will be undone.  ^R is
  899.      particularly important as in DESQview, files may have been created or
  900.      deleted in another window.  For more detail, see:  %r in Appendix A.
  901.  
  902.  
  903.      (S)ort
  904.  
  905.              (S)ort allows you to order the files in the display in virtually
  906.      any way imaginable, in either ascending or descending order.  The best way
  907.  
  908.  
  909.  
  910.                                  page -13-
  911.  
  912.      to get a feel for the flexibility of this command (as well as the @(S)ort
  913.      command) is to experiment with it.
  914.  
  915.  
  916.      @(S)ort                                                     NIOS
  917.  
  918.              This command provides an even more powerful, two-tiered sort. you
  919.      can, for instance, sort the display first by extension, then by date/time
  920.      within occurrences of the extension.
  921.  
  922.  
  923.              Sort settings and other program values can be made 'permanent' in
  924.      DV Tree in two ways, either globally or by specific directory. The two
  925.      methods are covered later in this document in the sections GLOBALS
  926.      SAVE/VIEW and DIRECTORY CUSTOMIZATION.
  927.  
  928.  
  929.  
  930.  
  931.      ┌─────────────────────────────────────┐
  932.      │  DV TREE'S COMMAND HISTORY FEATURE  │
  933.      └─────────────────────────────────────┘
  934.  
  935.              If you have experimented with the commands in the previous
  936.      section, you will have seen on a few occasions a window appearing in the
  937.      center of the display to prompt you for input.  This is a 'common' window
  938.      that is shared by many commands and features, and it itself has a 'hidden'
  939.      feature.  That is, it not only will 'remember' the last string entered for
  940.      a particular command, but it will 'remember' the last eight strings
  941.      entered for any reason.  To test this, hit K to bring up the Mas(K)
  942.      prompt.  Now, see what happens when you use your cursor keys:  The down
  943.      cursor key should show you the last command you entered, while the up
  944.      cursor key will start a backward search.
  945.  
  946.              The maximum length of an input string supported by this feature is
  947.      50 characters; if you enter something longer than this, characters beyond
  948.      the 50th will be truncated when later shown.
  949.  
  950.              This 'hidden' feature of the input prompt may be useful in a
  951.      number of ways, especially in situations when you find yourself entering
  952.      complicated input.  Also, in the section MORE FUN WITH DESQVIEW FUNCTIONS,
  953.      there is an example of how to create a DOS 'slave' window for DV Tree for
  954.      which DV Tree's command history may be used to remember DOS commands in a
  955.      way similar to DOS command line history programs.
  956.  
  957.              The command history buffer can even be saved from the (Z)pecial
  958.      menu so that it is retained for future executions of DV Tree.  To save the
  959.      current command history buffer, key Z-L from the main screen.  You can use
  960.      this capability for any number of things, from saving often used match
  961.      strings for the '=' command, to saving common but complex DOS commands for
  962.      use with a 'slave' DOS window.
  963.  
  964.  
  965.  
  966.  
  967.                                  page -14-
  968.  
  969.  
  970.  
  971.  
  972.      ┌─────────────────────────────────────┐
  973.      │  NAVIGATING DRIVES AND DIRECTORIES  │
  974.      └─────────────────────────────────────┘
  975.  
  976.              DV Tree allows you to view the DOS directory structure of your
  977.      disk(s) in graphical, or 'tree' format, and the standard way to change
  978.      current directories in the program is via the (T)ree main screen command.
  979.      Other ways of changing directories are covered at the end of this section.
  980.  
  981.  
  982.      (T)ree
  983.  
  984.              The (T)ree command pops up a window showing a section of the DOS
  985.      tree on the current drive of which the current directory is a part.
  986.      Unless your drive has more than 215 subdirectories, this will be a
  987.      cursor-scrollable tree that will wrap around from bottom to top or vice
  988.      versa as you move your up and down cursor keys.
  989.  
  990.              The Tree window may also be repositioned with the paging commands
  991.      described for the file display in the section titled CONTROLLING THE FILE
  992.      DISPLAY.  In brief:
  993.  
  994.  
  995.      PageUP/PageDN                                               NIOS
  996.  
  997.              Positions the tree window forward or backward by a 'page'.
  998.  
  999.  
  1000.      ^PageUP/^PageDN                                             NIOS
  1001.  
  1002.              Positions to either the first or the last 'page' of the tree.
  1003.  
  1004.  
  1005.      = (Jump)
  1006.  
  1007.              Allows a 'jump' based on a high level name match.  New features
  1008.      added in version 2.3:
  1009.  
  1010.                                                                  N2.3
  1011.           -  'Fuzzy' search ability.  If the input begins with '=', DV Tree
  1012.              looks for a match anywhere in the file or directory name.  For
  1013.              example, '=com' will find COMMAND.COM, MYCOM.BAT, FC.COM, etc..
  1014.  
  1015.           -  While strings are being entered, DV Tree will adjust its displays
  1016.              accordingly.  Note:  This feature is NOT available for 'large
  1017.              trees' (trees for which cursor scrolling is not active.)  As this
  1018.              facility may conflict with scripts depending on high speed key
  1019.              entry into the prompt window, it may be disabled with the NOHOP
  1020.              command line option.
  1021.  
  1022.  
  1023.  
  1024.                                  page -15-
  1025.  
  1026.  
  1027.  
  1028.      Backspace ('next' Jump)                                     NIOS  N2.1
  1029.  
  1030.              Repeats the effect of the = command.
  1031.  
  1032.  
  1033.      Home/End                                                    NIOS
  1034.  
  1035.              Positions the cursor bar, respectively, over the first or last
  1036.      directory shown.
  1037.  
  1038.  
  1039.              If your current drive has greater than 215 subdirectories, you
  1040.      will have to use the above commands to navigate the tree as the cursor bar
  1041.      will not cause the tree to scroll.  However, there is a way to 'klip'
  1042.      entries from large trees covered later in the section MANAGING TREES that
  1043.      might allow you to reduce your visible tree size below 216 directories and
  1044.      hence allow you to use the cursor scroll function.
  1045.  
  1046.              To select a new directory for the file display, position the
  1047.      cursor bar over the desired directory and hit Enter or the Spacebar (or
  1048.      the left mouse button).  The tree window will go away, and the file
  1049.      display will be reloaded with the contents of the new directory.  Other
  1050.      commands to try are:
  1051.  
  1052.  
  1053.      > (DOS prompt character or 'greater than sign')             NIOS (tree)
  1054.  
  1055.              This command is applicable to both the main and tree windows.  DV
  1056.      Tree will pop up a window with a list of your available DOS drives, and a
  1057.      new drive may be selected by letter.  If the command is used on the tree,
  1058.      you will be presented with the tree of the selected drive. On the main
  1059.      display, the > command will cause a direct 'jump' to the current
  1060.      directory on the drive selected.
  1061.  
  1062.  
  1063.      . (dot)                                                  NIOS N2.3 (N2.2)
  1064.  
  1065.              This command is functionally equivalent to > - added for ease of
  1066.      use as it is the unshifted state of > on most keyboards.
  1067.  
  1068.  
  1069.      (S)witch
  1070.  
  1071.              This command is in every way identical to the > command, but it is
  1072.      available only on the tree window ('S' on the main screen means (S)ort.)
  1073.  
  1074.  
  1075.  
  1076.  
  1077.                                  page -16-
  1078.  
  1079.  
  1080.      Escape                                                      NIOS
  1081.  
  1082.              The ESC key will simply remove the tree window as if it were just
  1083.      another scrolling menu.  Your current directory will not be changed.
  1084.  
  1085.  
  1086.              As mentioned at the beginning of this section, there are other
  1087.      ways to change directories in DV Tree besides the tree.  These ways are:
  1088.  
  1089.              1)  The > command                 (already discussed.)
  1090.              2)  Directory Hot-Keys            (covered later in THE DIRECTORY
  1091.                                                 HOT-KEY FEATURE.)
  1092.              3)  Direct selection by name      (with the ^D toggle on - see
  1093.                                                 the section THE CONFIGURABLE
  1094.                                                 TOGGLES.)
  1095.              4)  @= from the (F)ind display    (covered in THE FIND COMMAND.)
  1096.  
  1097.  
  1098.  
  1099.  
  1100.      ┌────────────────────────────┐
  1101.      │  FILE MANAGEMENT COMMANDS  │
  1102.      └────────────────────────────┘
  1103.  
  1104.              The file management commands are the 'backbone' of any file
  1105.      management program, and with DV Tree this is no exception.  The following
  1106.      commands give you the power to quickly organize and reorganize the files
  1107.      in your system:
  1108.  
  1109.  
  1110.      (D)elete
  1111.  
  1112.              The (D)elete command performs a function identical to the DOS DEL
  1113.      command.  Hitting (D)elete will result in a confirmation window.  If you
  1114.      have marked files, the confirmation window will tell you how many files
  1115.      you have marked for deletion.  If you have not marked files, the
  1116.      confirmation window will tell you the name of the file it is prepared to
  1117.      delete (the pointed-at file.)  To abort the delete operation, type N for
  1118.      'NO', or hit ESC.  If you respond 'Y' to the confirmation, the marked
  1119.      files, or the single pointed-at file, will be deleted.
  1120.              The delete operation does not actually destroy the file data
  1121.      immediately; destruction will occur over time as you copy files or create
  1122.      new files on your disk.  If you accidentally delete an important file, you
  1123.      can recover it if you have a program with an 'undelete' function (this
  1124.      function is not available in DV Tree.)  If you find yourself in such a
  1125.      situation, the best thing to do is immediately cease using your computer
  1126.      until you have 'undeleted' the file in question.
  1127.              Please note that (D)elete cannot delete a file with its READ-ONLY
  1128.      attribute set on.  If you want to delete such a file, you will have to
  1129.      first use the (A)ttr command (covered below), to turn off the READ-ONLY
  1130.      attribute.
  1131.  
  1132.  
  1133.  
  1134.                                  page -17-
  1135.  
  1136.  
  1137.  
  1138.      (C)opy
  1139.  
  1140.              The (C)opy command allows you to copy the single pointed-at file,
  1141.      or multiple marked files, to other directories or drives.  Hitting (C)opy
  1142.      will automatically bring up the tree display of the current drive along
  1143.      with a small work window in the top left of the screen that tells you how
  1144.      many bytes you've selected to copy, and how much free space is available
  1145.      on the drive you are currently positioned to copy to.  While the tree is
  1146.      displayed for the copy operation, most of the normal tree screen commands
  1147.      are available.  That is, while you are copying files, you are allowed to:
  1148.  
  1149.              *  Cursor scroll and using page and positioning commands.
  1150.              *  Switch destination drives via the > or (S)witch commands.
  1151.              *  (R)ename a directory.
  1152.              *  (A)dd a new subdirectory anywhere on the tree.
  1153.              *  Use the Re(B)uild command to reread the directory structure
  1154.                 from the disk.
  1155.              *  Toggle the 'Klipped' tree on and off.
  1156.  
  1157.              Details on the tree commands not already covered in NAVIGATING
  1158.      DRIVES AND DIRECTORIES are covered later in the section TREE MANAGEMENT.
  1159.  
  1160.              To select a destination for the copy operation, position the
  1161.      cursor bar over the selected directory and hit Enter or the Spacebar.
  1162.      An exception to this occurs if you select a floppy disk via the > or
  1163.      (S)witch command, and the floppy disk has no subdirectory structure.  In
  1164.      this case, DV Tree will assume you want to copy the files to the floppy's
  1165.      'root' directory (if one can be said to exist!) and proceed with the
  1166.      operation.
  1167.  
  1168.              If you select a destination disk on which there is insufficient
  1169.      free space to hold the files you are copying, DV Tree will give you a
  1170.      warning message and ask whether or not you want to attempt to proceed with
  1171.      the copy operation.  A situation when you might want to do this is when
  1172.      you are trying to overlay files at the destination with files of the same
  1173.      name.  You should respond Y or N to this prompt as the situation demands.
  1174.  
  1175.              Once the copy operation is underway, if DV Tree discovers that a
  1176.      file with same name as one you are copying exists at the destination, you
  1177.      will see another warning prompt that gives you the option of proceeding
  1178.      with the copy, skipping the file in question, proceeding without asking
  1179.      any more questions (because, let's say, you already know your copy
  1180.      operation is going to overlay many files at the destination), or skipping
  1181.      all files that turn out to have duplicate names.  At the bottom of this
  1182.      window, there are two display lines designed to aid you in your decision.
  1183.      These lines tell you the size, date, and time of the source file (on a
  1184.      line labeled SRC:), and the size, date, and time of the destination file
  1185.      (on a line labeled DEST:).  To abort the entire copy operation from this
  1186.      window, hit the ESC key.
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                                  page -18-
  1192.  
  1193.              As the copy proceeds, a window in the top right corner of the
  1194.      screen will keep you informed of DV Tree's progress, telling you the file
  1195.      it is currently working on, and the number of bytes successfully moved.
  1196.  
  1197.  
  1198.      (M)ove
  1199.  
  1200.              Use of the (M)ove command results in a quick confirmation prompt
  1201.      to make sure you want to move files.  If you reply Y, the move proceeds.
  1202.      (M)ove is logically identical to a (C)opy followed immediately by
  1203.      (D)elete. However, when moving files to another directory on the same
  1204.      logical DOS drive, the move operation is very quick because DV Tree is
  1205.      able to 'cheat' by simply renaming the files.  For details on the move
  1206.      command, reread the explanation of (C)opy (thinking 'move' every time the
  1207.      word 'copy' appears.)
  1208.              (M)ove's confirmation prompt is designed as a safeguard to make
  1209.      sure you actually want to move files, rather than copy them.  If you are
  1210.      an experienced user, you might find this prompt of negligible benefit.  If
  1211.      so, you may 'defeat' it by using a DESQview script that keys 'M' followed
  1212.      immediately by 'Y'.  A practical key for such a script assignment is @M
  1213.      (alt-M).  A very impractical key would be ^M (ctrl-M) because DOS, via a
  1214.      wacky quirk, considers ^M to be equivalent to the Enter key.
  1215.  
  1216.  
  1217.      (R)ename
  1218.  
  1219.              The (R)ename command will present you with an input prompt for you
  1220.      to enter a new name for the pointed-at file.  To abort the operation, hit
  1221.      Escape.
  1222.              If you attempt to rename a file to a name that already exists in
  1223.      the directory, DV Tree will give you an option to 'overwrite' the existing
  1224.      file.  If the overwrite fails, the probable cause is that the 'file' with
  1225.      the same name is either a READ-ONLY file, or a subdirectory.
  1226.  
  1227.  
  1228.      (A)ttr
  1229.  
  1230.              The (A)ttr command gives you the power to alter the DOS file
  1231.      attributes of the pointed-at file or directory if no files are marked, or
  1232.      a group of files if files are marked.  These attributes include the
  1233.      SYSTEM, the HIDDEN, the READ-ONLY, and the ARCHIVE attributes.  The SYSTEM
  1234.      attribute is usually only found 'on' for the main files that comprise the
  1235.      DOS operating system.  The ARCHIVE attribute is intended for use by file
  1236.      backup programs - if you don't use a backup program to save your data, you
  1237.      will discover that the ARCHIVE attribute for almost all the files on your
  1238.      system will be on, and if you do use a file backup program, you'll
  1239.      discover that the ARCHIVE attribute is on only for files that have been
  1240.      changed since the last backup.  The HIDDEN and READ-ONLY attributes may be
  1241.      used by various applications on your system to protect files for their own
  1242.      purposes.
  1243.  
  1244.  
  1245.  
  1246.                                  page -19-
  1247.  
  1248.  
  1249.              In general, you probably won't want to use the (A)ttr command very
  1250.      much, but it's there if you need it.  One of the reasons you might want to
  1251.      use it is to enable you to delete a file that has its READ-ONLY attribute
  1252.      on (this situation might occur if you're attempting to delete an
  1253.      application from your system that utilized certain forms of copy
  1254.      protection.)  When you use the (A)ttr command, DV Tree presents a small
  1255.      window with entries for the four attributes listed above.  Attributes that
  1256.      are on will be highlighted, and you may use the Enter key or the Spacebar
  1257.      to toggle all of the attributes on and off.  When you have set the
  1258.      attributes the way that you want them, hit ESC.  DV Tree will ask you
  1259.      whether you really want to change the attributes for the file or files in
  1260.      question, and if you reply Yes, the attributes will be changed.
  1261.  
  1262.  
  1263.      @(C)opy  (or 'Alternate Copy')                              NIOS
  1264.  
  1265.              The @(C)opy command produces the alternate copy menu with the
  1266.      following options:
  1267.  
  1268.              Create (Clone)
  1269.              Append to File
  1270.  
  1271.              The Create (Clone) option allows you to create a duplicate copy of
  1272.      the file in the current directory by giving the duplicate (or 'clone') a
  1273.      different name.
  1274.  
  1275.              The Append to File option allows you to 'tack' the pointed-at file
  1276.      (which should usually be an ASCII text file) onto the end of another file.
  1277.  
  1278.              The best way to understand these two commands is to try them out.
  1279.  
  1280.  
  1281.  
  1282.  
  1283.      ┌────────────────────┐
  1284.      │  THE FIND COMMAND  │
  1285.      └────────────────────┘
  1286.  
  1287.      (F)ind/@(F)ind
  1288.  
  1289.              DV Tree's (F)ind command gives you a very powerful, alternate way
  1290.      of managing your files.  The (F)ind command returns a sub-menu with the
  1291.      following options:
  1292.  
  1293.              File Mask
  1294.              Date (Equal)
  1295.              Since Date
  1296.              Before Date
  1297.              Attributes
  1298.  
  1299.  
  1300.  
  1301.                                  page -20-
  1302.  
  1303.              > Size
  1304.              < Size
  1305.              = Size
  1306.  
  1307.              In it's simplest form, (F)ind can help you locate a file about
  1308.      which you can remember the name or a part of the name, but not what
  1309.      directory you put it in.  To do this, select File Mask on the sub-menu,
  1310.      and enter a file mask for the find operation.  Remember that (F)ind has
  1311.      dynamic wildcard logic, so entering AUTO will cause (F)ind to respond as
  1312.      if you had entered AUTO*.*.  The (F)ind file mask, by the way, also
  1313.      supports the '?' DOS wildcard character (unlike the Mas(K) command.)
  1314.  
  1315.              After you have entered a file mask, (F)ind will ask you if you
  1316.      want to search only the current directory and its subdirectories.  If you
  1317.      reply N to this question, (F)ind will perform the search across your
  1318.      entire hard drive.  Replying Y, on the other hand, will cause (F)ind to
  1319.      limit its search to just a portion of the tree, thus resulting in a much
  1320.      quicker response from the program.
  1321.  
  1322.              If the (F)ind display is active and you initiate a second,
  1323.      different (F)ind command, you will also be given the option to append the
  1324.      results of the new find operation to the end of the current list.
  1325.  
  1326.              Once you have created a (F)ind display, it is possible for you to
  1327.      use virtually all of the commands available when you are in the 'normal'
  1328.      directory display.  That is, you are free to mark files, delete files,
  1329.      copy files, rename files, change attributes, even use the (S)ort or
  1330.      @(S)ort commands to get the list into any order you like.  You can also
  1331.      use the ^R (refresh) command to repeat the find operation.
  1332.  
  1333.              This, of course, isn't all.  As you might guess from the option
  1334.      list, (F)ind can also locate files in a variety of other ways.  After
  1335.      selecting and entering input for anything other than 'file mask' on the
  1336.      sub-menu, you will also be prompted for a file mask, so you can use the
  1337.      additional options either to 'qualify' a file mask other than *.*, or to
  1338.      search independently with respect to the various characteristics by
  1339.      entering '*' into the file mask prompt (if '*.*' is not already there.)
  1340.  
  1341.              Another thing you should know is that if you use the @(F)ind
  1342.      command, all of the prompts will be primed with the appropriate
  1343.      information related to the pointed-at file.  In other words, if the cursor
  1344.      bar is pointing at a file with a file date of, say, 01/04/91, you can find
  1345.      all files on your hard disk with the same date using the following series
  1346.      of commands:
  1347.  
  1348.              @(F)ind                         (alternate (F)ind)
  1349.              Type D                          (for 'Date (Equal)')
  1350.              Hit Enter                       ('01/04/91' is already loaded)
  1351.              Type *                          (to clear the mask to *.*)
  1352.              Hit Enter                       (to 'go')
  1353.              Hit ESC                         (to scan the whole drive)
  1354.  
  1355.  
  1356.  
  1357.  
  1358.                                  page -21-
  1359.  
  1360.              In other words, the @(F)ind command in the above example saved you
  1361.      the need to key in the 8 character date for 01/04/91.  Similar examples
  1362.      might be given for the find options related to file size and file
  1363.      attributes, and you might also note that the command sequences are such
  1364.      that you could easily Learn them into a DESQview script.
  1365.  
  1366.              To get used to the (F)ind and @(F)ind commands, the best thing to
  1367.      do is experiment.  Some possible uses you might discover for the (F)ind
  1368.      command include:
  1369.  
  1370.              1)  Scanning for *.bat so you can copy all of the batch files on
  1371.                  your hard drive to a single floppy disk (or even have them
  1372.                  compressed onto the floppy with an archiving program like
  1373.                  PKZIP - see the example in MORE FUN WITH DESQVIEW FUNCTIONS.)
  1374.              2)  Scanning for files with a file size < 1 so you can delete
  1375.                  them (note:  Scanning for size = 0 will not work.)
  1376.              3)  Scanning for *.bak so you can delete back-up files and regain
  1377.                  some space.
  1378.              4)  Scanning for files with sizes greater than 100000 bytes so
  1379.                  you can learn just where all that free space you once had on
  1380.                  your 40-meg hard drive has gone.
  1381.              5)  Scanning for files with their READ-ONLY or HIDDEN attributes
  1382.                  on (just out of curiosity.)
  1383.              6)  Scanning for *.exe and/or *.com so you can experiment with
  1384.                  DV Tree's (E)xec and @(E)xec commands (described later in the
  1385.                  section DESQVIEW SPECIFIC FEATURES.
  1386.  
  1387.  
  1388.              DV Tree has the following additional commands to provide you with
  1389.      even more flexibility when using (F)ind:
  1390.  
  1391.  
  1392.      -  (the minus key, aka the (F)ind toggle)                   NIOS
  1393.  
  1394.              The - (minus key) will quickly toggle between the (F)ind
  1395.      display and the current, 'normal' directory.  Memory permitting, DV Tree
  1396.      does its best to keep to the 'found' list readily available (to avoid a
  1397.      repeat of the (F)ind process).
  1398.  
  1399.  
  1400.      @=  (the (F)ind 'jump' command)                             NIOS
  1401.  
  1402.             When you are in the (F)ind display, the = (equal) key pressed in
  1403.      combination with the @ (Alt) key, will act like a directory selection key,
  1404.      causing a 'jump' to the directory containing the pointed-at file in the
  1405.      (F)ind display.
  1406.  
  1407.             Another small, but useful, thing occurs when you use @= :  The file
  1408.      jump mask is automatically primed with the name of the file you selected,
  1409.      so if you follow @= immediately with the = or backspace key and Enter,
  1410.      you'll not only jump to the file's directory, but you'll also position the
  1411.      display so that the file you jumped 'with' is at the top and readily
  1412.  
  1413.  
  1414.  
  1415.                                  page -22-
  1416.  
  1417.      visible (now isn't that the sort of tip that makes trudging through this
  1418.      manual worthwhile?!)
  1419.  
  1420.  
  1421.      Some final notes on (F)ind:
  1422.  
  1423.              1)  Although (F)ind will not operate on more than one drive at a
  1424.      time, you can 're-perform' the current (F)ind on different drives in the
  1425.      following way:
  1426.  
  1427.              Type >                          (the 'switch drives' command)
  1428.              select a new drive
  1429.              Type -                          (the (F)ind toggle)
  1430.              repeat the above 3 commands as many times as you like
  1431.  
  1432.              2)  The default date used to prime the input prompt for date-
  1433.      oriented (F)ind commands is a configurable option.  See the section
  1434.      GLOBALS SAVE/VIEW.
  1435.  
  1436.              3)  One of the reasons (F)ind is so fast is that it uses the
  1437.      current tree to determine the directories you want it to search, unlike
  1438.      other hard disk scan programs that have to build a tree as they work.
  1439.      This also means, however, that DV Tree won't find files if they exist in
  1440.      directories that do not exist in DV Tree's tree structure (such as a
  1441.      directory created outside of DV Tree since the last time the tree was
  1442.      rebuilt.)
  1443.  
  1444.              Find will also not find files in 'klipped' subdirectories unless
  1445.      the 'Unklipped' tree is active.  The meaning of these terms can be found
  1446.      in the section MANAGING TREES.
  1447.  
  1448.  
  1449.  
  1450.  
  1451.      ┌───────────────────────────────────────┐
  1452.      │  EXPLOITING THE SPLIT SCREEN FEATURE  │
  1453.      └───────────────────────────────────────┘
  1454.  
  1455.              In the earlier section, MANIPULATING THE DISPLAY, you were shown
  1456.      how to get into split screen using the / key, and also how to flip the
  1457.      split direction and end split screen mode from the [ or 'Split Menu'.
  1458.      Since then, split screen has not been mentioned and we've assumed that you
  1459.      weren't using DV Tree in split screen mode in the previous sections, even
  1460.      though you may have been, because everything works exactly the same!
  1461.  
  1462.              When you use the / key to put DV Tree into split screen mode, the
  1463.      only 'detrimental' things that happen are:
  1464.  
  1465.              1)  You see fewer files (or less information) per directory.
  1466.              2)  Each side of the split is capable of handling only half the
  1467.                  the number of files the program can manage when not in
  1468.  
  1469.  
  1470.  
  1471.                                  page -23-
  1472.  
  1473.                  split screen (and this is a configurable value, covered
  1474.                  later in the sections CONFIGURATION and COMMAND LINE OPTIONS.)
  1475.  
  1476.              Of course, split screen has its benefits.  Perhaps the most useful
  1477.      purpose for split screen mode is its functionality when it comes to
  1478.      supporting copy/move operations.  Using split screen, it is possible for
  1479.      you to not only 'see where you are coming from', but also to 'see where
  1480.      you are going to'.
  1481.  
  1482.              In MANIPULATING THE DISPLAY, it was mentioned how the use for the
  1483.      TAB key changes when the screen is split vertically.  The TAB key has yet
  1484.      another purpose:  When you're in split screen, and you initiate a copy or
  1485.      a move operation, the TAB key allows you to quickly select the directory
  1486.      in the opposite split as the destination directory. In other words,
  1487.      copy/move operations from one split side to the other can be a quick, two
  1488.      or three step operation:
  1489.  
  1490.              (C)opy/(M)ove
  1491.              TAB                             (to select opposite directory)
  1492.              Hit Enter                       (if not a floppy with no tree)
  1493.  
  1494.              Beyond this, there is even a way to make DV Tree automatically
  1495.      select the opposite directory as the copy/move destination - refer to the
  1496.      description of ^C in THE CONFIGURABLE TOGGLES.
  1497.  
  1498.              Split screen also has a set of commands that can be particularly
  1499.      useful if you are working with two drive/directory combinations that
  1500.      contain similar or identical files - perhaps one might be a 'working'
  1501.      directory for one of your favorite applications, while the other is a
  1502.      floppy disk or another directory that you use to keep back-up copies of
  1503.      some of your important work:
  1504.  
  1505.  
  1506.      [-M     (Split menu-Match Identical)
  1507.  
  1508.              This command gives you a way to quickly mark files on both sides
  1509.      of the split that have identical characteristics - that is, they have the
  1510.      same name, size, date, time, and attributes.
  1511.  
  1512.  
  1513.      [-N     (Split menu-Name Only)
  1514.  
  1515.              This command gives you a way to quickly mark files on both sides
  1516.      of the split that have identical names.
  1517.  
  1518.  
  1519.      [-T     (Split menu-Tag Newer)                              N2.3
  1520.  
  1521.              This command will mark the newer copy of any files with a name
  1522.      match.  If files with the same name are identical, they will not be
  1523.      marked.
  1524.  
  1525.  
  1526.  
  1527.  
  1528.                                  page -24-
  1529.  
  1530.  
  1531.      [-L     (Split menu-Lock Toggle)
  1532.  
  1533.              The 'Lock toggle' is particularly powerful in this situation.
  1534.      Like other toggles, alternating uses of it turn it off and on.  The
  1535.      current status of the Lock toggle can be seen on the bottom display line
  1536.      when you are split screen mode.
  1537.  
  1538.              When the lock toggle is ON, a subset of DV Tree's normal commands
  1539.      will, when used, perform their functions on both sides of the split.  The
  1540.      commands are:
  1541.  
  1542.              PageUP/PageDN
  1543.              The = ('jump' command)
  1544.              The backspace ('jump next') command
  1545.              The TAB key (if your split is horizontal)
  1546.              Mas(K)/@(M)ask
  1547.              (U)nmark
  1548.              E(X)clude
  1549.              (S)ort
  1550.              @(S)ort (two-tiered sort)
  1551.  
  1552.              Please notice that (C)opy, (M)ove, and (D)elete are absent from
  1553.      the above list.
  1554.  
  1555.  
  1556.              Let's return to our hypothetical example of a work directory and
  1557.      its back-up counterpart.  For the purposes of the following example,
  1558.      we'll assume that the lock toggle is on.
  1559.              The first thing you might want to try is to mark the files in both
  1560.      directories that are exactly the same.  To do this, use the [-M command.
  1561.              At this point, depending on what you're doing, you might want to:
  1562.  
  1563.              1)  Delete the duplicates in the back-up directory.
  1564.              2)  E(X)clude the marked files so you can examine just the
  1565.                  differences between the two directories.  From here you
  1566.                  might move on to:
  1567.  
  1568.                      A)  Copying all non-duplicate files from the work
  1569.                          directory to the back-up directory.
  1570.                      B)  Using the [-N command to mark the files with
  1571.                          the same name (but different characteristics)
  1572.                          so you can more readily see the differences.
  1573.  
  1574.  
  1575.              As you might guess from the example, the choices are all up to
  1576.      you!
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                  page -25-
  1582.  
  1583.  
  1584.      Some final notes on Split Screen:
  1585.  
  1586.              1)  The split screen direction (horizontal or vertical) is a
  1587.      configurable option.  Refer to GLOBALS SAVE/VIEW.
  1588.  
  1589.              2)  It is possible to have DV Tree initiate in split screen,
  1590.      either in the same or in different directories or drive/directory
  1591.      combinations. Refer to COMMAND LINE OPTIONS.
  1592.  
  1593.              3)  If you use split screen a lot, and you have an enhanced
  1594.      (101-key) AT keyboard, you might want to use a DESQview script to define
  1595.      your @[ key to do a quick horizontal/vertical flip.
  1596.  
  1597.              4)  There's even more!  (see the next section.)
  1598.  
  1599.  
  1600.  
  1601.  
  1602.      ┌──────────────────────────────────────────┐
  1603.      │  ^\ - THE 'TEMPORARY' DIRECTORY COMMAND  │
  1604.      └──────────────────────────────────────────┘
  1605.  
  1606.  
  1607.      ^\                                                          NIOS  N2.1
  1608.  
  1609.              You can use the special ^\ command to quickly create a temporary
  1610.      subdirectory off the current directory with a name of TEMP$.DVT, and
  1611.      switch to this subdirectory in the right half or bottom half of a screen
  1612.      split.
  1613.              Also, if the screen is not already split, this command will cause
  1614.      a split to occur.  If the screen IS already split, the current directory
  1615.      (either side) will end up in the left or top of the split after the
  1616.      command has completed.
  1617.  
  1618.              You can use the temporary directory like any other directory, and
  1619.      DV Tree will attempt to delete it when:
  1620.  
  1621.              1) Split screen is ended with the [-E command.
  1622.              2) Another CTRL-\ command is entered
  1623.              3) When DV Tree is exited via the Q or @Q commands.
  1624.  
  1625.              Of course, if you have left files in the temporary directory, the
  1626.      delete will fail, and the directory will remain in the tree.  At this
  1627.      point, you will have to either manually delete it to get rid of it, or
  1628.      rename it to something more meaningful.  Or...  you could just leave it
  1629.      there, and DV Tree will reuse it the next time you use ^\ with the display
  1630.      positioned to the same parent directory....
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.                                  page -26-
  1639.  
  1640.      ┌──────────────────┐
  1641.      │  MANAGING TREES  │
  1642.      └──────────────────┘
  1643.  
  1644.              Now that all the major aspects of the main screen commands have
  1645.      been covered, it's time to focus on what you can do with Trees.  DV Tree
  1646.      provides the following commands to aid you in maintaining and managing
  1647.      the directory structure(s) of your hard drive(s):
  1648.  
  1649.  
  1650.      (A)dd
  1651.  
  1652.              The (A)dd command gives you a way to create a new subdirectory off
  1653.      off the pointed-at directory.  DV Tree will prompt you for the new name,
  1654.      and if all goes well, the directory will be created, and an entry for it
  1655.      will be inserted into the tree.
  1656.  
  1657.  
  1658.      (D)el
  1659.  
  1660.              The (D)el command gives you a way to delete the pointed-at
  1661.      directory and remove it from the tree.  The (D)el command will only work
  1662.      on a directory that is empty - that is, a directory that has no files in
  1663.      it, and no subdirectories attached to it.  Also, (D)el will not work on
  1664.      a current directory.
  1665.  
  1666.  
  1667.      (R)ename
  1668.  
  1669.              The (R)ename command allows you to change the name of the
  1670.      pointed-at directory in much the same way as you can change the name of a
  1671.      normal file.
  1672.  
  1673.  
  1674.      Re(B)uild
  1675.  
  1676.              The Re(B)uild command is what you must use if you want to recreate
  1677.      the tree for a given drive from the information actually on the disk in
  1678.      question.  Under normal conditions, DV Tree will rarely do this on its
  1679.      own.
  1680.              One of the reasons you might want to use Re(B)uild is after you've
  1681.      created a new subdirectory on your disk outside of DV Tree.
  1682.  
  1683.  
  1684.      (M)ove                                                      N2.1
  1685.  
  1686.              (M)ove is a powerful tree screen command that lets you move entire
  1687.      directories, along with their subdirectory structures, to a new location
  1688.      in the same tree.  To use (M)ove, select the directory you want to
  1689.      relocate with the cursor bar, and key M.  A window titled 'Cut/Paste
  1690.      Directory' should appear at the top right of the screen, indicating that
  1691.      DV Tree is ready to move the directory whose name is displayed in this
  1692.  
  1693.  
  1694.  
  1695.                                  page -27-
  1696.  
  1697.      window.  At this point, you can abort the move operation by hitting
  1698.      Escape.
  1699.              To proceed with the move, position the cursor bar over the desired
  1700.      destination directory, and hit Enter or the Spacebar.
  1701.  
  1702.  
  1703.      (K)lip
  1704.  
  1705.              The (K)lip command gives you a way to put the pointed-at directory
  1706.      'out of sight' - in this way, it's similar to the E(X)clude main screen
  1707.      command.  When you (K)lip a directory, it remains on the disk (and, in
  1708.      fact, in the tree), but you won't normally see it.
  1709.              The purpose of this command is to give you a way to make
  1710.      navigating your trees more manageable by hiding subdirectories that are
  1711.      normally just in the way and that you will seldom, if ever, need to access
  1712.      with DV Tree.
  1713.              If you use (K)lip to hide a directory with subdirectories, all of
  1714.      the subdirectories will be 'klipped' as well.
  1715.  
  1716.  
  1717.      + (The 'Klip' toggle)                                       NIOS
  1718.  
  1719.              The + (plus key) tree command gives you a way to see your 'full'
  1720.      tree after you have used the (K)lip command to remove one or more
  1721.      directories.  Alternating use of the + command toggles the 'UnKlipped'
  1722.      tree on and off.  When the 'UnKlipped' tree is active, you will be able to
  1723.      tell because the title of the tree window will be 'UnKlipped!'
  1724.  
  1725.  
  1726.      (U)nklip
  1727.  
  1728.            The (U)nklip command undoes the effect of the (K)lip command.
  1729.      (U)nklip works on the pointed-at directory, and if this directory has
  1730.      subdirectories (that will also, necessarily, be klipped), it will give the
  1731.      option to 'unklip' them as well.
  1732.              The (U)nklip command, of course, can do nothing useful unless you
  1733.      have used the + toggle to make the full, 'UnKlipped' tree visible.
  1734.  
  1735.  
  1736.  
  1737.                                      Part 3:
  1738.                             DESQview Specific Features
  1739.                             --------------------------
  1740.  
  1741.  
  1742.      ┌────────────────────────────┐
  1743.      │  DV TREE'S (E)XEC COMMAND  │
  1744.      └────────────────────────────┘
  1745.  
  1746.  
  1747.      (E)xec
  1748.  
  1749.              The (E)xec command lets you 'execute' the pointed-at .COM, .EXE,
  1750.      or .BAT file in a DESQview window without having to define the program as
  1751.      a DESQview Application.  This can be a good thing, or a bad thing; the
  1752.      window used by this command is a 'Writes Directly to Screen',
  1753.      non-virtualized, foreground only window.  These characteristics can't be
  1754.      changed, and they may not be the optimum characteristics for any given
  1755.      program running in DESQview.  If you have a program you will often want to
  1756.      run under DESQview, you should create an Open Menu entry for that program
  1757.      using Add a Program (or by cheating by using Change a Program on an
  1758.      application with similar characteristics, then changing the title, the
  1759.      Open Keys, the program path, etc..)
  1760.  
  1761.              That pointed out, (E)xec does have its uses, particularly when
  1762.      you'd like to run a small game or other simple program, or 'test drive' a
  1763.      new program, without having to open a DOS window.  DV Tree attempts to
  1764.      tailor the DESQview memory allocated to the window according to the file
  1765.      size of the pointed-at file.  The default equation is:
  1766.  
  1767.              File Size + 64K  (or 128K, whichever is larger)
  1768.  
  1769.              Both the addition value (64K), and the minimum value (128K) are
  1770.      under your control - see the section CONFIGURATION.  You may need to
  1771.      increase these values if you want to use (E)xec to launch large programs
  1772.      started from small batch files.
  1773.  
  1774.              An additional note on .BAT files:  The (E)xec window is 'Close on
  1775.      Exit', meaning the first program executed within a .BAT file will result
  1776.      in the batch file itself ending, and the window closing.  In most
  1777.      instances, this is the most desirable action, but if you want to use
  1778.      (E)xec to initiate complex batch files that execute multiple programs,
  1779.      this presents a problem.  For an 'work-around', see Exhibit C in MORE FUN
  1780.      WITH DESQVIEW FUNCTIONS.
  1781.  
  1782.                                                                  N2.1
  1783.              You can also 'tie' the (E)xec command to DESQview Function
  1784.      definitions if you have applications whose data files use a common suffix.
  1785.      For instance, if your word processor's document files have the suffix
  1786.      ".WP5", you can use the (E)xec command to load or re-load your word
  1787.      processor with any of its files.  This feature can be particularly useful
  1788.      for mouse users as (E)xec is on the mouse menu, but F-Keys are not.  To
  1789.      accomplish this, you should:
  1790.  
  1791.  
  1792.  
  1793.  
  1794.                                  page -29-
  1795.  
  1796.              1)  Set up a DESQview Function key for your word processor (or
  1797.      other application) and test it.  DESQview Functions are covered
  1798.      extensively in following sections of this manual.
  1799.  
  1800.              2)  Add %X??? (where ??? is a file extension) to the end of your
  1801.      DESQview Function code string for the application.  More detail is given
  1802.      for the %X code in Appendix A.
  1803.  
  1804.              To facilitate the application launching aspects of (E)xec, the
  1805.      command may be 'reassigned' to either the Enter key or the Spacebar.
  1806.      Refer to the section COMMAND LINE OPTIONS for more information.
  1807.  
  1808.  
  1809.      @(E)xec                                                     NIOS
  1810.  
  1811.              @(E)xec is a variation on (E)xec.  For @(E)xec, DV Tree opens a
  1812.      window that allows you to specify a memory value other than the default,
  1813.      plus any command line parameters you might wish to pass to the program.
  1814.  
  1815.              One of the best uses for the @(E)xec command is its ability to let
  1816.      you 'fine tune' the memory requirements of a program you want to add to
  1817.      DESQview - in other words, it is much easier to repeatedly test a program
  1818.      with different memory values using the @(E)xec command than it is with
  1819.      repeated uses of Change a Program.
  1820.  
  1821.  
  1822.  
  1823.  
  1824.      ┌─────────────────────────────────────────────────┐
  1825.      │  (P)RINT - A FILE-ORIENTED 'MARK AND TRANSFER'  │
  1826.      └─────────────────────────────────────────────────┘
  1827.  
  1828.  
  1829.      (P)rint/@(P)rint                                            NIOS  N2.1
  1830.  
  1831.              These commands allow you to 'print' the pointed-at file into the
  1832.      window immediately underlying DV Tree.  (P)rint does an exact, character
  1833.      for character transfer, while @(P) will try to 'intelligently' strip out
  1834.      carriage returns (Enter keystrokes) to allow the receiving application to
  1835.      word-wrap.
  1836.  
  1837.              The utility of these commands very likely depends on the
  1838.      applications that you use.  They're primarily intended to help overcome
  1839.      the shortcomings of editor-like applications with insufficient facilities
  1840.      for pulling ASCII, or 'text', files into existing documents.  Many
  1841.      existing E-Mail oriented applications have this problem - (P)rint and
  1842.      @(Print) operate by typing the pointed-at file directly into the
  1843.      underlying application through its keyboard, exactly as if you'd done it
  1844.      manually.
  1845.  
  1846.              You may also find @(P)rint useful for reformatting large amounts
  1847.      text in an editor program, or for first time loading of an ASCII file into
  1848.  
  1849.  
  1850.  
  1851.                                  page -30-
  1852.  
  1853.      a word processor that would normally, using the word processor's methods,
  1854.      result in large numbers of 'hard' carriage returns at the ends of lines as
  1855.      well as paragraphs.
  1856.  
  1857.              Please note that these commands are designed for ASCII text files.
  1858.      We do not recommend their use on other sorts of data files (such as word
  1859.      processing files with imbedded formatting directives.)
  1860.  
  1861.              The 'underlying window' these commands 'print' into is the
  1862.      application directly beneath DV Tree's top left corner.  If no application
  1863.      is there, DV Tree will produce an error message and do nothing.
  1864.  
  1865.  
  1866.  
  1867.  
  1868.      ┌──────────────────────────────────────┐
  1869.      │  INTRODUCTION TO DESQVIEW FUNCTIONS  │                    N2.1
  1870.      └──────────────────────────────────────┘
  1871.  
  1872.              In this section you will learn about DV Tree's most important and
  1873.      most exciting feature - the ability to launch other DESQview Applications
  1874.      while, at the same time, 'feeding' them information such as the pointed-at
  1875.      filename, the name of the current directory, and many other possibilities
  1876.      besides these.
  1877.  
  1878.              It cannot be overly stated that this capability is the one and
  1879.      only real reason why DV Tree exists at all.  All the other 'nice' features
  1880.      of the program, such as the (F)ind command and the Split Screen feature
  1881.      are just icing on the cake (unless you want to chalk them up to some sort
  1882.      of weird, late-night, bit-juggling masochism on the part of the author) -
  1883.      the DESQview Functions feature is truly the 'meat' of DV Tree.
  1884.  
  1885.              Because of the flexibility and relative complexity of some aspects
  1886.      of DESQview Functions, the best way to proceed is to get away from cliche
  1887.      food analogies and work by doing.
  1888.  
  1889.              For all the examples in this section, we will use a single
  1890.      DESQview Application:  Vernon Buerg's shareware LIST program (experienced
  1891.      users feel free to substitute LISTS.COM).  If you do not have a copy of
  1892.      LIST, you can:
  1893.  
  1894.              1)  Run DV Tree's (F)ind with a mask of 'LIST' on your hard drive
  1895.      - this wonderful program is so common that it may be lurking somewhere
  1896.      in the recesses of your system without you even knowing it!
  1897.  
  1898.              2)  Try to get one quick; it's available in one version or another
  1899.      on virtually every bulletin board system (BBS) known to Man.
  1900.  
  1901.              3)  Select a suitable substitute program.  Ideally the substitute
  1902.      program should be either an ASCII file viewer or an editor with the
  1903.      capability of accepting an input filespec on the DOS command line and the
  1904.      ability either to handle multiple files internally (as LIST can) or reload
  1905.  
  1906.  
  1907.  
  1908.                                  page -31-
  1909.  
  1910.      a new file once running.  Once you have done this, you are ready to
  1911.      proceed (thinking the name of your substitute program each time LIST is
  1912.      mentioned.)
  1913.  
  1914.              The process we will follow is broken down into several objectives.
  1915.      If you're confident you can accomplish the stated objective without
  1916.      directions, feel free to skip the (rather detailed) directions as you see
  1917.      fit and accomplish the objective on your own.
  1918.  
  1919.  
  1920.         ┌───────────────────────────────────────────────────────────────┐
  1921.         │                                                               │
  1922.         │    Objective 1:  Make LIST a 'DESQview Application'.  This    │
  1923.         │       consists of creating an Open Menu entry for LIST.       │
  1924.         │                                                               │
  1925.         └───────────────────────────────────────────────────────────────┘
  1926.  
  1927.  
  1928.              Tap your DESQ key               (probably ALT)
  1929.              Type O                          (for Open)
  1930.              Type AP                         (for Add a Program)
  1931.              Type O                          (for Other)
  1932.              Hit F1                          (for Specify Program Information)
  1933.              Key in a title                  ('LIST for DV Tree' might be ok)
  1934.              TAB                             (to Open Keys)
  1935.              Key some keys                   ('LL' might be good)
  1936.              Key 85                          (in 'Memory in K' (use 32k for
  1937.                                                                 LISTS.COM))
  1938.              TAB                             (to 'Program...:' field)
  1939.              type the full path to LIST.COM
  1940.              TAB                             (to 'Parameters:' field)
  1941.              Hit your Spacebar               (to clear the field)
  1942.              Hit Enter                       (to Add List)
  1943.              Hit Enter again                 (to say you're done)
  1944.  
  1945.  
  1946.              LIST should now be available on your DESQview Open Menu (you can
  1947.      check to make sure if you like.)
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.                                  page -32-
  1956.  
  1957.         ┌───────────────────────────────────────────────────────────────┐
  1958.         │                                                               │
  1959.         │    Objective 2:  Assign the LIST application to DV Tree's     │
  1960.         │       F1 key so that we can load any file into LIST by        │
  1961.         │      positioning DV Tree's cursor bar over the file in        │
  1962.         │                   question, and hitting F1.                   │
  1963.         │                                                               │
  1964.         └───────────────────────────────────────────────────────────────┘
  1965.  
  1966.  
  1967.              Now that LIST is an official DESQview Application, we will link it
  1968.      to a DESQview Function Key in DV Tree.  From DV Tree's main screen, type
  1969.      (Z)pecial, followed by 'D'.
  1970.  
  1971.              At this point, it's time for a brief explanation of what you
  1972.      should be seeing:  There should be two windows over the DV Tree main
  1973.      screen, a large one on the right with a list of all available DESQview
  1974.      Applications, and a smaller one in the middle-left with a line each for F1
  1975.      through F10.  The DESQview Functions feature works by assigning any of 30
  1976.      possible F-Keys to DESQview Applications.  What you see in the smaller
  1977.      window is the assignment status of the 'normal' F1 through F10 keys.  If
  1978.      you hit your TAB key, you can scroll this window to see the bank of
  1979.      assignments for @F1 through @F10 and ^F1 through ^F10.
  1980.  
  1981.              Unless you've gotten ahead of this 'tutorial/manual', you should
  1982.      see {undefined} next to each and every possible F-Key assignment.  Before
  1983.      we move on, if you've used the TAB key to scroll through the banks, use it
  1984.      some more until the bottom line of the smaller window informs you that you
  1985.      are looking at the assignments for the 'Main' bank - the bank for the
  1986.      'normal' F-Keys.
  1987.  
  1988.              Now - on to assigning LIST.  Use your cursor keys to position the
  1989.      cursor bar in the right hand window over the entry for LIST (if you have
  1990.      more than one page of DESQview Applications, you may have to use PageDN to
  1991.      obtain the next page in order to see the line for LIST.)  Once you've
  1992.      positioned your cursor bar, hit F1.
  1993.  
  1994.              You should now see a window titled 'Startup Method'.  Select 'Pass
  1995.      filespec on Command Line'.  This should result in the window going away,
  1996.      and an entry appearing next to the F1 line in left-hand window to inform
  1997.      you that you've assigned LIST successfully.  Hit ESC until you've returned
  1998.      to DV Tree's main screen.
  1999.  
  2000.              While you're here, play a little - with the cursor bar over any
  2001.      filename in the display, hit F1.  The LIST application should open and
  2002.      load immediately with the pointed-at file.  (On the outside chance that it
  2003.      doesn't, key Z-C-.(dot) from DV Tree's main screen and make sure that the
  2004.      .DVP path specification correctly specifies the full DOS pathname to your
  2005.      main DESQview directory.)
  2006.  
  2007.              Pretty nifty, huh?  Hit ESC, then open LIST again on another
  2008.      file....  You can even switch back to DV Tree and open multiple LIST
  2009.  
  2010.  
  2011.  
  2012.                                  page -33-
  2013.  
  2014.      windows at the same time (and be able to switch quickly between them via
  2015.      two rapid taps on your DESQ (probably Alt) key.
  2016.  
  2017.  
  2018.         ┌───────────────────────────────────────────────────────────────┐
  2019.         │                                                               │
  2020.         │    Objective 3:  Use DESQview's Learn feature to create a     │
  2021.         │    script in the LIST application on key {255} that will      │
  2022.         │    bring the LIST application to its internal file reload     │
  2023.         │                          prompt.                              │
  2024.         │                                                               │
  2025.         └───────────────────────────────────────────────────────────────┘
  2026.  
  2027.  
  2028.              This step is where things begin to get a little more complex....
  2029.      The objective now is to use DESQview's Learn feature to give us a way to
  2030.      reload a running LIST application with a new file.  To do this, we will
  2031.      Learn a script on ASCII key {255}:
  2032.  
  2033.              1)  In the LIST window, hold down your Shift key, and tap your
  2034.      DESQ key (probably Alt.)
  2035.  
  2036.              2)  You should now be at DESQview's Learn menu (if not, try step
  2037.      one again - believe it or not, it can be tricky).  Let go of your Shift
  2038.      key, and hit your Enter key (for 'Start Script').  DESQview should respond
  2039.      with a window asking you to tell it the key you want to define.
  2040.  
  2041.              3)  We want to make this key {255}.  To do this, hold down your
  2042.      Alt key, and keep it down(!)  On the numeric keypad of your keyboard type
  2043.      '255', and let go of your Alt key.
  2044.  
  2045.              4)  If you successfully performed step 3, you should see
  2046.      DESQview's 'Start a Script' window, and a line in that window that says
  2047.      'Key: {255}'  If this is not true, hit ESC until DESQview again asks what
  2048.      key you want to define, then retry step 3.
  2049.  
  2050.              5)  At the prompt in the 'Start a Script' window, give this script
  2051.      a title ('Load new file' might be a good one.)  When you've composed your
  2052.      title, hit Enter.
  2053.  
  2054.              6)  DESQview is officially 'Learning' your {255} script.  To get
  2055.      LIST to its internal file reloading prompt, hit @F (alt-F).  If you've
  2056.      done this correctly, the bottom left hand corner of your LIST window
  2057.      should say 'New File:'.
  2058.  
  2059.              7)  Hold down your Shift key again and tap DESQ to bring back
  2060.      DESQview's Learn menu.  Tell DESQview to 'Finish Script' by hitting your
  2061.      Enter key.
  2062.  
  2063.              8)  Bring back the Learn menu (Shift-Alt), and tell DESQview to
  2064.      save the script file (Key 'S' followed by Enter.)
  2065.  
  2066.  
  2067.  
  2068.  
  2069.                                  page -34-
  2070.  
  2071.  
  2072.              With luck, you've successfully defined a {255} script that DV Tree
  2073.      can use to load LIST with additional files.  To make sure, you can close
  2074.      the LIST window we've been using and open a new one.  In the new window,
  2075.      hold down your Alt key (and keep it down), then key 255 on your numeric
  2076.      keypad and release your Alt key.  If LIST responds by presenting the New
  2077.      File: prompt in the bottom left hand corner of the window (without any
  2078.      accompanying beeps or strange side effects), then you've won (!).  If not,
  2079.      you can try repeating the above steps anew, and you might also want to
  2080.      refer to your DESQview manual so that you understand more fully what we're
  2081.      trying to do with DESQview's Learn feature.
  2082.  
  2083.  
  2084.         ┌───────────────────────────────────────────────────────────────┐
  2085.         │                                                               │
  2086.         │    Objective 4:  Modify DV Tree's 'understanding' of the      │
  2087.         │    LIST application so that it knows how to exploit the       │
  2088.         │             {255} script that we just defined.                │
  2089.         │                                                               │
  2090.         └───────────────────────────────────────────────────────────────┘
  2091.  
  2092.  
  2093.              With the {255} script successfully defined for LIST, we can begin
  2094.      to get 'fancy' with DV Tree.  In the DV Tree window, key Z-D to get to
  2095.      DESQview Functions, hit F1, and tell DV Tree you want to 'Edit Code
  2096.      String'.  You should see an input prompt loaded with:  %c%p . Change the
  2097.      string so that it looks like this:
  2098.  
  2099.              %c%p%A&z%p%e
  2100.  
  2101.              When you're finished, hit Enter.  If all is well, you can ESC back
  2102.      to DV Tree's main screen and try your F1 key again.  This time, instead of
  2103.      opening a new LIST application, DV Tree should reload the currently
  2104.      running LIST with the new file.  And because LIST can handle multiple
  2105.      files at once, the 'old' file should also be there:  ^PageUP in LIST takes
  2106.      you to the previous file, and ^PageDN takes you in the other direction.
  2107.  
  2108.  
  2109.         ┌───────────────────────────────────────────────────────────────┐
  2110.         │                                                               │
  2111.         │    Objective 5:  Expand on what we've just done so that       │
  2112.         │    we can have LIST load or reload multiple files with a      │
  2113.         │                 single use of the F1 key.                     │
  2114.         │                                                               │
  2115.         └───────────────────────────────────────────────────────────────┘
  2116.  
  2117.  
  2118.              (Important note if you're NOT using LIST for this example:  Skip
  2119.      this objective if the program you are using does not support the handling
  2120.      of multiple files in some way.)
  2121.  
  2122.  
  2123.  
  2124.  
  2125.                                  page -35-
  2126.  
  2127.              This step is easy:  Repeat the steps in objective 4, but this time
  2128.      add %Z to the end of the code string so that it looks like this:
  2129.  
  2130.              %c%p%A&z%p%e%Z
  2131.  
  2132.              Hit ESC until you're back to DV Tree's main display, mark 4 or 5
  2133.      files with Enter or your Spacebar, hit F1, and watch what happens:  LIST
  2134.      should load all of the files you've marked, and you can test this by using
  2135.      ^PageUP and ^PageDN to find them all.  (If, by chance, all the files
  2136.      aren't there, or if you heard beeps when trying this, you probably need to
  2137.      add a 'delay code' to the code string to slow DV Tree down a little.  To
  2138.      add a half second delay between reloads, make the string look like this:
  2139.      %c%p%A&.5&z%p%e%Z  ).
  2140.  
  2141.              By the way, if you use F1 as it's presently defined in a display
  2142.      with no files marked, it will load LIST with only the pointed-at file, so
  2143.      you get the best of both worlds.  On the other hand, you may decide you
  2144.      don't want this multi-file capability and prefer to be able to LIST single
  2145.      files, while leaving marked files alone; in that case you might change F1
  2146.      back to the way it was in Objective 4 (or you could assign LIST to
  2147.      multiple keys and have all sorts of possible permutations....)
  2148.  
  2149.  
  2150.         ┌───────────────────────────────────────────────────────────────┐
  2151.         │                                                               │
  2152.         │    Objective 6:  (Optional, but recommended)  Compare the     │
  2153.         │    DESQview Function code strings you used in this example    │
  2154.         │    with their complete descriptions in Appendix A of this     │
  2155.         │    manual to help you understand exactly what you just did.   │
  2156.         │                                                               │
  2157.         └───────────────────────────────────────────────────────────────┘
  2158.  
  2159.  
  2160.              If all went well, you've just seen several practical examples of
  2161.      the most unique feature of DV Tree.  If you were already familiar with
  2162.      LIST, you may also have discovered capabilities you weren't aware that it
  2163.      had!  (And that isn't all - there's another neat 'trick' up LIST's sleeve
  2164.      that's shown later in MORE FUN WITH DESQVIEW FUNCTIONS).
  2165.  
  2166.              Although we used a single program as an example in this section,
  2167.      the steps we followed can, in principle, be applied to virtually any
  2168.      program you might want to run under DESQview.  It may take some ingenuity
  2169.      on your part to get the code string right, but if the program can load a
  2170.      file, whether on the command line or through keyboard input, DV Tree can
  2171.      likely load it with that file for you, as well as reload it with a new
  2172.      file whenever you desire.
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.                                  page -36-
  2180.  
  2181.  
  2182.      ┌─────────────────────────────────────┐
  2183.      │  RUNNING DV TREE IN A SMALL WINDOW  │                     N2.1
  2184.      └─────────────────────────────────────┘
  2185.  
  2186.              When using DV Tree to its full potential, such as in the example
  2187.      on LIST in the previous section, it may often be desirable to run it in
  2188.      less than the full screen window, thus leaving a portion of the underlying
  2189.      application visible on the monitor screen and giving DV Tree the effect of
  2190.      a 'pop up' file interface for the application. To accommodate this need,
  2191.      DV Tree acts in the following ways:
  2192.  
  2193.              1)  Paging commands on the main screen are 'aware' of the number
  2194.      of file entries visible on the screen and will act accordingly.  For
  2195.      example, if you've reduced the display to five visible lines, PageDn will
  2196.      move ahead 5 files.  With this feature, you could still have a useful DV
  2197.      Tree window even if you shrunk it to three or four visible lines in a
  2198.      skinny 3 x 13 window!
  2199.  
  2200.              2)  In split screen, if the window is small enough, the split swap
  2201.      commands (the '/' key and TAB in vertical split mode) will reposition the
  2202.      window so that the 'swapped to' side of the split becomes visible.
  2203.  
  2204.              3)  Also in split screen, if you've in some way 'shrunk' the
  2205.      window so that it 'hugs' one side of the split, the (F)lip Horz/Vert
  2206.      command on the split menu ([) will cause the window to be resized to
  2207.      compliment the changed format.
  2208.  
  2209.              To try DV Tree in a small window, you can use DESQview's Resize
  2210.      function (on the Rearrange menu) to test various window sizes.  You may
  2211.      also want to try using the version of DV Tree's PIF shipped as TZ-PIF.DVP
  2212.      (Open Keys 'TZ' if you added this to DESQview's Open Menu during
  2213.      installation.)  The 'TZ' PIF is nothing more than a variation on DESQview
  2214.      Tree 100K - the only differences are that it comes up in a 22 x 30 window,
  2215.      and has OPP=* on the command line to throw it automatically into split
  2216.      screen mode.
  2217.  
  2218.              DV Tree also has one more main screen command intended for use
  2219.      when running in this way:
  2220.  
  2221.  
  2222.      * @ESC                                                      NIOS  N2.1
  2223.  
  2224.              This command requests DV Tree to bring the application directly
  2225.      beneath its top left corner to the foreground.  This key is not available
  2226.      on non-enhanced keyboards, but a script could be manually created (or
  2227.      'Learned' on a machine that does support @ESC) to reassign it to an
  2228.      available key.
  2229.              This command is useful because, if you use DV Tree as a pop-up
  2230.      file menu, it's a quick, common way to 'just make the menu go away'.
  2231.  
  2232.  
  2233.  
  2234.  
  2235.                                  page -37-
  2236.  
  2237.              Final note:  If you habitually run in high-resolution mode on an
  2238.      EGA or VGA monitor, you should also read the EGA/VGA section later in this
  2239.      document.
  2240.  
  2241.  
  2242.  
  2243.  
  2244.      ┌────────────────────────────────────────┐
  2245.      │  SETTING UP A HELP SYSTEM FOR DV TREE  │                  N2.1
  2246.      └────────────────────────────────────────┘
  2247.  
  2248.              One of the reasons why DV Tree can be so fast and small is that it
  2249.      has no built-in help system beyond the Option Summary.  However, many of
  2250.      the commands aren't shown on the Option Summary, and the author will not
  2251.      argue the fact that help would be useful.  Because of this, DV Tree comes
  2252.      with a short text file shipped as DVQUICK.REF that gives you as short a
  2253.      summary of all the available commands as possible.
  2254.  
  2255.              You may be thinking, "But that's not a help system!"  You're
  2256.      right, it isn't.  But...  If you've worked through the previous section or
  2257.      have for any other reason created a DESQview Open Menu entry for LIST or
  2258.      any other file viewing program, you can create your own help for DV Tree
  2259.      by doing Change a Program on your LIST (or other) definition and:
  2260.  
  2261.              Key a new title                 ('DV Tree Help' might work)
  2262.              Tab                             (to 'Open Keys')
  2263.              Change the keys                 (use '00' or something like that,
  2264.                                               i.e. something you wouldn't
  2265.                                               normally use)
  2266.              TAB 2 times                     (to 'Parameters:' field)
  2267.              type the full path to DVQUICK.REF
  2268.              Hit Enter                       (to finish this)
  2269.  
  2270.              You can test this quickly by doing an Open on 00 (assuming those
  2271.      were the keys you used.)
  2272.  
  2273.              To complete the process, use DESQview's Learn to create a script
  2274.      in the DV Tree window:
  2275.  
  2276.              Get the Learn menu              (Probably Shift-Alt)
  2277.              Hit Enter                       (Start Script)
  2278.              Hit @H                          (a good key for help, no?)
  2279.              Type a title                    ('Help' or something like that)
  2280.              Hit Enter                       (to start 'Learning')
  2281.              Tap your DESQ key               (probably Alt)
  2282.              Hit O                           (for 'Open')
  2283.              Hit 00                          (the keys you used last step)
  2284.              Get the Learn menu again        (Probably Shift-Alt)
  2285.              Hit Enter                       (Finish Script)
  2286.  
  2287.              Now, switch back to DV Tree, get back the Learn Menu, and save
  2288.      your script.
  2289.  
  2290.  
  2291.  
  2292.                                  page -38-
  2293.  
  2294.  
  2295.              If all has gone well, you can view DVQUICK.REF at any time in DV
  2296.      Tree by hitting @H (and who said multi-tasking was only good for
  2297.      background file transfers?)
  2298.  
  2299.              Please note that while you've 'Learned' this script for one DV
  2300.      Tree window, you may also need to Learn it in the others (if you use
  2301.      them). However, there's a trick you can use for this sort of situation:
  2302.      In the 'other' DV Tree windows, Learn a script named '!Startup' that
  2303.      brings up the Learn menu and loads your 'main' DV Tree script file
  2304.      (TL-SCRIP.DVS, or whatever).  Doing it this way gives you only one DV
  2305.      Tree script file to maintain, and this is especially useful if you use a
  2306.      lot of scripts.  (If you DO use a lot of scripts, you might find
  2307.      something of interest in the DVSCRIP1.ZIP archive that's included with
  2308.      DV Tree.)  (You might already have done the above during install of 2.2+)
  2309.  
  2310.             You should also consider the DVQUICK.REF file to be entirely yours.
  2311.      Many of the commands in it you will learn by heart very quickly (or
  2312.      consider redundant because they are also in the Option Summary.)  The
  2313.      power is yours to use a text editor to 'cull' whatever you already know
  2314.      from the commands listed so that what you don't know or feel you might not
  2315.      remember stands out more prominently.  Another thing you might decide to
  2316.      do as you become more experienced with DESQview Functions, is move the
  2317.      DESQview Function reference to the top, since, in practice, you're more
  2318.      likely to need it handy more often than any other part of the file.
  2319.  
  2320.             Another DESQview Functions help Tip:  If you find yourself doing
  2321.      lots of work with DESQview Functions, and you haven't printed out this
  2322.      manual (or even if you have), using a text editor to copy Appendix A to
  2323.      the end of DVQUICK.REF might be a very good idea.
  2324.  
  2325.  
  2326.  
  2327.  
  2328.      ┌────────────────────────────────────┐
  2329.      │  MORE FUN WITH DESQVIEW FUNCTIONS  │                      N2.1
  2330.      └────────────────────────────────────┘
  2331.  
  2332.  
  2333.              This section's purpose is to expand on the INTRODUCTION TO
  2334.      DESQVIEW FUNCTIONS using more real world examples.  However, we will
  2335.      also assume that you at least know how to perform 'basic' tasks such as
  2336.      'Learning' DESQview scripts, getting into the part of DV Tree where you
  2337.      can define DESQview Functions, and creating and changing DESQview
  2338.      Applications for your programs.  In this sense, this section is written
  2339.      for the theoretical audience of the 'knowledgeable user'.
  2340.  
  2341.              Before we 'dig in', a little philosophy is in order:  DESQview is
  2342.      designed to run applications in separate windows or partitions, and DV
  2343.      Tree is designed to maximize this capability.  However, a lot of people
  2344.      tend to do a lot of work in DESQview's generic 'Big DOS' window or other
  2345.      DOS windows, thus avoiding the creation of separate Open Window entries
  2346.  
  2347.  
  2348.  
  2349.                                  page -39-
  2350.  
  2351.      for smaller programs.  For 'miscellaneous' sorts of work, this is okay,
  2352.      but in the end it defeats the purpose of multi-tasking, especially with
  2353.      respect to DV Tree.
  2354.  
  2355.              You might interpret the philosophy expressed here as a call to
  2356.      give your 'small' programs the credit they deserve - run them in small
  2357.      windows.  A version of LIST, LISTS.COM, will run well with all but a few
  2358.      features available in 32K with no problems at all.  Most good dedicated
  2359.      editors, such as the widely available Q-Edit, will also run wonderfully in
  2360.      very minimal amounts of memory - Q-Edit, to continue the example, can
  2361.      function as the perfect batch file editor in a 70K window.  This may make
  2362.      no difference to you if you have a 486 processor with 8 megs of memory,
  2363.      but most of us aren't there yet!
  2364.  
  2365.              To get the most out of DV Tree, you should create Open Menu
  2366.      entries for virtually all the software you use - word processors,
  2367.      spreadsheets, editors, listers, i.e. whatever you use often on a regular
  2368.      basis.  In some cases, you might end up with multiple Open Menu entries
  2369.      for the same program - the author has a 70K Q-Edit window assigned to F2,
  2370.      a 200K Q-Edit window assigned to @F2, and a 400K Q-Edit window assigned to
  2371.      F8.  Granted, all three keys technically execute 'the same program', but
  2372.      in reality, each performs a different 'purpose' (one edits batch files,
  2373.      another edits text files, and the third edits the source code for the
  2374.      program you're reading about and using.)  There's a common myth in the DOS
  2375.      world that no 'useful' multi-tasking is possible on less than a 386
  2376.      processor with 2 megabytes of RAM.  Well, DV Tree was written on a 286
  2377.      clone blessed with only 1 Meg of RAM for most of its development cycle
  2378.      (the author now has a second meg that he proudly uses as a RAM disk.)
  2379.  
  2380.              With that out of the way, it's time for the 'FUN' promised in this
  2381.      section's title.  The idea is not only to present you with a lot more
  2382.      'real world' examples that work with DV Tree's DESQview Functions feature,
  2383.      but also give you ideas of how you might use DV Tree with the applications
  2384.      you already use, and perhaps even to suggest some programs that you don't
  2385.      use, but might find useful.
  2386.  
  2387.              It should be pointed out at this time that the real documentation
  2388.      for the DESQview Functions feature of DV Tree is all in Appendix A.
  2389.      Everything works by what we call 'code strings', and code strings are made
  2390.      up of sequences of 'codes' and normal characters.  A code begins with
  2391.      either the '%' (percent) sign, or the '&' (ampersand) sign.  With a few
  2392.      exceptions, codes are two characters in length.  To give an example, the
  2393.      code string generated when you select 'Pass filespec on Command Line'
  2394.      consists of two codes: %c%p.  When alphabetic characters appear as part of
  2395.      codes, they are case-sensitive (i.e. %c is not equivalent to %C).  %c
  2396.      tells DV Tree that you want to put something on the starting application's
  2397.      command line, and %p tells DV Tree what that something is, in this case,
  2398.      the full filespec of the pointed-at file.  Much more detail on this, and
  2399.      on all other codes, is available in Appendix A.
  2400.  
  2401.              You might guess from the above that %c is an important code.  In
  2402.      Appendix A, the various codes are divided into broad groups, and %c is one
  2403.  
  2404.  
  2405.  
  2406.                                  page -40-
  2407.  
  2408.      of the three 'major codes'.  The other major codes are %k, which tells DV
  2409.      Tree to send keystroke input, rather than command line input, to the
  2410.      starting application; and %A, which does the same thing as %k, but only if
  2411.      the application in question is already active.  %p, the full filespec
  2412.      code, is also major in the sense that it is the fully qualified filespec
  2413.      of the file you are pointing at when you hit an F-Key, and you're
  2414.      presumably hitting the F-Key because you want to do something with the
  2415.      file you're pointing at.
  2416.  
  2417.  
  2418.         ┌───────────────────────────────────────────────────────────────┐
  2419.         │                                                               │
  2420.         │              Exhibit A:  A bunch of miscellaneous             │
  2421.         │                      'real world' strings                     │
  2422.         │                                                               │
  2423.         └───────────────────────────────────────────────────────────────┘
  2424.  
  2425.  
  2426.               1)  Lotus 1-2-3 release 2                   %k&3/fr%E%E%p%e
  2427.               2)  Lotus 1-2-3 w/Logitech mouse            %k%e&5/fr%E%E%p%e
  2428.               3)  DESQview Notepad                        %k&1d%p%e
  2429.               4)  PKUNZIP to opposite split               %c%p%O%r
  2430.               5)  Use QP.COM to print in background       %c-f %p%-
  2431.  
  2432.  
  2433.               All of the above examples apply only to the initial file loading
  2434.      capability of DESQview Functions, not the reload capability.  They make a
  2435.      good 'sample group', however, because you can see how different the code
  2436.      string may look from application to application.  In fact, the only common
  2437.      thing among all these strings is that they each contain %p somewhere - the
  2438.      code to expand the name of the pointed-at file.
  2439.  
  2440.              The first two lines apply to the popular spreadsheet Lotus 1-2-3
  2441.      (release 2).  If you are a Lotus user, these codes may work for you as
  2442.      presented, or they may require modification (specifically, modification of
  2443.      the &3 and &5 delay codes if you have a slow machine.)  Incidentally,
  2444.      these are not necessarily the optimal codes for Lotus, especially if you
  2445.      think being able to quickly load different spreadsheets via DV Tree might
  2446.      be useful - these strings are just good examples of fairly complex
  2447.      keystroke input situations; note the %E (ESC) codes.  A good project might
  2448.      be to try to implement the reload feature for LOTUS so that your string
  2449.      looks something like this:
  2450.  
  2451.               %k&3&z%p%e%A&z%p%e               (Lotus 1-2-3 release 2)
  2452.  
  2453.              To be able to do this, you need to first Learn a {255} script
  2454.      for Lotus (this is what is required for the &z code) that brings it to
  2455.      its file reload prompt (i.e., it contains the keystrokes /fr ESC ESC ).
  2456.      Also notice how the delay code &3 is still in the string.  Delays are
  2457.      almost always necessary in %k and %A strings.
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.                                  page -41-
  2464.  
  2465.              The string for the DESQview companion DESQview Notepad is shown as
  2466.      another example of an application that cannot take input on the DOS
  2467.      command line.
  2468.  
  2469.  
  2470.              The notable element of the string for PKUNZIP is the %O code - a
  2471.      code especially useful when working in split screen.  If you create a
  2472.      PKUNZIP DESQview Application with a memory size of around 128K, these
  2473.      codes can enable you to 'unzip' the pointed-at ZIP file into the directory
  2474.      in the opposite split, or, if the screen is not split, the directory in
  2475.      the directory line of the PKUNZIP PIF (i.e. The 'Directory.:' field on
  2476.      page 1 of Change a Program).  If the PIF directory is blank, DV Tree will
  2477.      cause unzipping to occur into the current directory.  The %r code says
  2478.      that when PKUNZIP is finished and DV Tree again becomes foreground, the
  2479.      displayed directories will be automatically updated.
  2480.  
  2481.              PKUNZIP/DV Tip:  In setting up a PIF for PKUNZIP, it is often
  2482.      useful to place a '?' in the Parameters: field on Add/Change a Program.
  2483.      The ? causes the PKUNZIP window to pause at startup, allowing you to add
  2484.      additional parameters to PKUNZIP's command line.  This is useful because
  2485.      it allows you to add file masks for specific files if you want to limit
  2486.      what's extracted from the zip file, but if you just hit Enter when the
  2487.      window is paused, PKUNZIP will proceed to extract all files.
  2488.  
  2489.              If you are a regular user of PKUNZIP and/or other archive
  2490.      management programs, you should also take the time to review the contents
  2491.      of the UTILITY.ZIP file distributed with DV Tree.  Among other things,
  2492.      you'll find a batch file you can run against ANY archive file type in
  2493.      order to invoke the appropriate un-archive program, plus an example of how
  2494.      to set up a DESQview Function for the common FV.COM (also by V. Buerg of
  2495.      LIST fame) that will let you quickly get a list of the contents of an
  2496.      archive file of virtually any type.
  2497.  
  2498.              The last example for QP.COM is good because it shows how you can
  2499.      mix normal DOS command line parameters with the actual codes in the code
  2500.      string.   QP.COM is a small utility (distributed as QUPIE.ZIP) that does a
  2501.      nice job of performing background print functions (and you can use the %-
  2502.      code, as in this example, to have the program start in the background.)
  2503.  
  2504.  
  2505.         ┌───────────────────────────────────────────────────────────────┐
  2506.         │                                                               │
  2507.         │              Exhibit B:  PKZIP and the %@ code                │
  2508.         │                                                               │
  2509.         └───────────────────────────────────────────────────────────────┘
  2510.  
  2511.  
  2512.              In this exhibit we'll refer to PKZIP, but if you use a different
  2513.      archive manager, the same principles will very likely apply.  PKZIP,
  2514.      specifically, will usually run well in a 128K window.
  2515.  
  2516.  
  2517.  
  2518.  
  2519.                                  page -42-
  2520.  
  2521.              Here are two example strings for use with PKZIP:
  2522.  
  2523.              PKZIP to opposite split                 %c%Q08 %d\*.*%O%r
  2524.              PKZIP using @list                       %c%Q08 @%@ %O%r
  2525.  
  2526.              Both strings begin by:
  2527.  
  2528.              Specifying command line input           (%c)
  2529.              Opening an 8 character input window     (%Q08)
  2530.  
  2531.              The %Q08 code gives you an input window for the zip file name,
  2532.      then the first example goes on to:
  2533.  
  2534.              adding the current directory filespec   (%d)
  2535.              appending the characters \*.*           (to get all the files)
  2536.  
  2537.              In the second example we:
  2538.  
  2539.              add the @ character                      (PKZIP's @list parameter)
  2540.              add the %@ code
  2541.  
  2542.              The %@ code causes DV Tree to create a work file in the DV Tree
  2543.      directory containing the names of all the files you have marked in the
  2544.      current display (it could be a directory display, or a (F)ind display.)
  2545.      DV Tree then adds the name of this file to the command line.  With this
  2546.      setup, PKZIP should proceed to create a zip file from all the files you
  2547.      have marked.
  2548.  
  2549.              Depending on the way you use PKZIP, you might want to modify the
  2550.      examples to include some of PKZIP's other command line parameters such as
  2551.      -m or -r.
  2552.  
  2553.               The two examples each have their advantages, though the second is
  2554.      the most versatile.  In the first you have a single keystroke way of
  2555.      zipping up everything in the current directory.  In the second, however,
  2556.      you have a way to selectively run PKZIP, but if you want to get all of the
  2557.      current directory, you first have to mark all the files (probably by using
  2558.      the Mas(K) command.)
  2559.  
  2560.  
  2561.         ┌───────────────────────────────────────────────────────────────┐
  2562.         │                                                               │
  2563.         │              Exhibit C:  Creating a variation on              │
  2564.         │                    DV Tree's (E)xec command                   │
  2565.         │                                                               │
  2566.         └───────────────────────────────────────────────────────────────┘
  2567.  
  2568.  
  2569.              The 'hard-coded' nature of the PIF used to start a program when
  2570.      you use (E)xec is explained in section DESQVIEW SPECIFIC FEATURES.  You
  2571.  
  2572.  
  2573.  
  2574.                                  page -43-
  2575.  
  2576.      can overcome this by creating a DESQview Application with nothing in
  2577.      Program.: field, and assigning this to an F-Key with 'Pass filespec on the
  2578.      command line'.
  2579.  
  2580.              The resulting DESQview Function will act similarly to (E)xec,
  2581.      except that in this instance, the various parameters of the PIF, such as
  2582.      screen virtualization and 'Close on Exit', are now completely under your
  2583.      control via Change a Program.  If your intention in creating this DESQview
  2584.      Function is, in fact, to set 'Close on Exit' to No to give you a way to
  2585.      run complex batch files, you might also want to do the following:
  2586.  
  2587.              1)  Add %Xbat to the end of the code string for the function; this
  2588.      will 'tie' the F-Key to the (E)xec command and, in the process, override
  2589.      the parameters for .BAT files only.
  2590.  
  2591.              2)  Add the statement EXIT to the end of your batch files; this
  2592.      will give you control on exactly when the .BAT file DOES exit and cause
  2593.      the window to close.
  2594.  
  2595.  
  2596.         ┌───────────────────────────────────────────────────────────────┐
  2597.         │                                                               │
  2598.         │              Exhibit D:  Using LIST as a text search          │
  2599.         │                             utility.                          │
  2600.         │                                                               │
  2601.         └───────────────────────────────────────────────────────────────┘
  2602.  
  2603.  
  2604.             Recent versions of Vernon Buerg's LIST (LIST75a+) have the
  2605.      capability to start a multiple file text scan through use of the /F
  2606.      command line option.  We can exploit this easily by assigning the LIST
  2607.      application to a second F-Key with the following codes:
  2608.  
  2609.              %c*.* /F%?%D
  2610.  
  2611.              The meaning of the codes (as all other codes used in this
  2612.      section), may be found in Appendix A.
  2613.  
  2614.              A LIST F-Key setup in this way will give you an input prompt
  2615.      window for a text string to search for, then open LIST to search for the
  2616.      string through all the files in the current directory
  2617.  
  2618.              A note re:LIST:  Once the first occurrence of the string is found,
  2619.      LIST's @A (alt-A) command will continue the search through the remaining
  2620.      files (the LIST F3 and A commands will not load the next file.)
  2621.  
  2622.              Depending on how you work, you may want to replace *.* in the
  2623.      example with the %i code.
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.                                  page -44-
  2632.  
  2633.         ┌───────────────────────────────────────────────────────────────┐
  2634.         │                                                               │
  2635.         │              Exhibit E:  A 'Slave' DOS window with            │
  2636.         │                      command memory.                          │
  2637.         │                                                               │
  2638.         └───────────────────────────────────────────────────────────────┘
  2639.  
  2640.  
  2641.              This exhibit might be otherwise called a 'DV Tree trick' - that
  2642.      is, it takes advantage of several features in order to produce something
  2643.      quite different than anything that might readily be apparent.
  2644.  
  2645.              Even though DV Tree can do a great deal, there may be times when
  2646.      what you want to accomplish is best done directly from the DOS command
  2647.      line.  By using DV Tree's input prompt, you can do this via a DV Tree
  2648.      DESQview Function assigned to a DOS window with the following codes:
  2649.  
  2650.              %k&2%Q50%e%A%Q50%e
  2651.  
  2652.      Notes:
  2653.  
  2654.              1)  Things you might want to try in defining the DOS window are
  2655.      making it Writes Directly to Screen = N, and either leaving the starting
  2656.      row/col size blank, or using values to create a half-screen window.
  2657.  
  2658.              2)  A good thing to put in the Program...: field of a DOS window
  2659.      PIF might be CLS (rather than leaving it blank.)
  2660.  
  2661.              3)  A setup like this even gives you a 8 command history buffer
  2662.      in the input prompt window (see the section DV TREE'S COMMAND HISTORY
  2663.      FEATURE.)
  2664.  
  2665.  
  2666.         ┌───────────────────────────────────────────────────────────────┐
  2667.         │                                                               │
  2668.         │               Exhibit F:  A DOS XCOPY window                  │
  2669.         │                                                               │
  2670.         └───────────────────────────────────────────────────────────────┘
  2671.  
  2672.  
  2673.              In the section TREE MANAGEMENT, you learned how DV Tree can move
  2674.      directories and subdirectory structures to different locations on the same
  2675.      drive.  However, there may be times when you want to either duplicate a
  2676.      subdirectory structure on the same drive, or on different drive.  DOS
  2677.      provides XCOPY.EXE for this function, and you can exploit DV Tree's split
  2678.      screen to let you run an XCOPY DESQview Application quickly and easily,
  2679.      copying all files and subdirectories from the current side of the split to
  2680.      the opposite side with the following code string:
  2681.  
  2682.              %c%d /E /S%O%r
  2683.  
  2684.  
  2685.  
  2686.  
  2687.                                  page -45-
  2688.  
  2689.      With this example, the following happens:
  2690.  
  2691.              1)  The XCOPY application starts in the directory of the opposite
  2692.      side of the split (because of the %O code.)
  2693.              2)  XCOPY acts on the current directory (because of %d), and
  2694.      creates and copies subdirectories because of the command line parameters
  2695.      /E and /S.
  2696.              3)  DV Tree's display is refreshed when XCOPY finishes and DV Tree
  2697.      again comes foreground (because of %r.)
  2698.  
  2699.  
  2700.  
  2701.  
  2702.      ┌────────────────────────────────────────────┐
  2703.      │  MISCELLANEOUS DESQVIEW FUNCTIONS FEATURES │                    N2.3
  2704.      └────────────────────────────────────────────┘
  2705.  
  2706.              This section details various program features designed to support
  2707.      the creation and maintenance of DESQview Functions.
  2708.  
  2709.              From the main Z-D menu, it is possible to define 10 'user macro'
  2710.      strings.  You may consider these 10 strings as 'substrings' that can be
  2711.      expanded into normal code strings, letting you create code strings longer
  2712.      than 30 characters, along with the ability to crunch commonly used
  2713.      sequences into two character positions:
  2714.  
  2715.              *  To define any of these strings, hit a numeric key (0-9).
  2716.  
  2717.              *  To expand a user macro string in another code string, use %n
  2718.      (where n = the numeric key you've defined).
  2719.  
  2720.              Please note that, in order to keep the macro string function as
  2721.      flexible as possible, DV Tree does not attempt to validate the correctness
  2722.      of macro code string sequences, so the only way to find out if you coded
  2723.      something correctly is by hitting an F-Key that expands the macro, and
  2724.      making sure you've achieved the desired result.
  2725.  
  2726.              Also in support of DESQview Functions, the following options are
  2727.      available on the menu when an already assigned function key is hit from
  2728.      the main Z-D menu:
  2729.  
  2730.  
  2731.      (E)dit Code String   ---  self-explanatory
  2732.      (U)nassign Key       ---  self-explanatory
  2733.  
  2734.  
  2735.      (C)lone Code String ( + (L)oad Cloned Codes )
  2736.  
  2737.              This option copies the key's existing code string into a temporary
  2738.      buffer so that you may later apply it to another function key, either at
  2739.      initial assignment by selecting (L)oad with Cloned Codes, or from this same
  2740.      menu by selecting (L)oad Cloned Codes.  This can be particularly useful in
  2741.  
  2742.  
  2743.  
  2744.                                  page -46-
  2745.  
  2746.      cases where you want to 'move' a function key, or produce a new key that
  2747.      is a variation on one you already use.
  2748.  
  2749.  
  2750.      (A)ssign .EXT File ( + (R)eload .EXT file )
  2751.  
  2752.              These options control the linking of a key with a .EXT file.  Use
  2753.      Assign to create the link, and reload when you have updated a .EXT file
  2754.      and want DV Tree to recognize your changes.  For more information, see the
  2755.      section USING .EXT FILES.
  2756.  
  2757.  
  2758.      (T)itle Edit
  2759.  
  2760.              Title edit is a powerful as well as a complex option.  On the
  2761.      surface, it simply allows you to change the title of the application to
  2762.      something different than that shown on DESQview's Open Menu.  Some ways
  2763.      you might take advantage of this feature:
  2764.  
  2765.              1)  When you have the same application defined multiple times for
  2766.      different purposes, you can give each instance a more descriptive name.
  2767.  
  2768.              2)  When you have PIFs that are not on DESQview's Open Menu, you
  2769.      can give them names other than ??-PIF.DVP.
  2770.  
  2771.              Note:  You can remove an alternate title by spacing out the
  2772.      alternate title prompt.
  2773.  
  2774.              The complexity of this option comes into play mostly with respect
  2775.      to the %A code that tells DV Tree what to do when the application assigned
  2776.      to a function key is already active, and what happens in these cases
  2777.      depends on whether or not you are running DVTXDI.  But assuming you are
  2778.      using DVTXDI, you should be aware of the following:
  2779.  
  2780.              1)  When DV Tree looks for an active application, it first checks
  2781.      to see if it 'remembers' starting one.  If this check fails, it then asks
  2782.      DVTXDI if there is another application running with this one's 'open
  2783.      keys', and if so, recognizes this as a copy of the application you are
  2784.      trying to use.  This can be either good or bad when you have multiple
  2785.      function keys assigned to the same application, all depending on how you
  2786.      are trying to use them.
  2787.  
  2788.              2)  To have DV Tree treat two iterations of the same application
  2789.      as different applications, you *must* assign an alternate title to at
  2790.      least one of the function keys, and you *must* use the %T code in the code
  2791.      string of each.  When the %T code is present DV Tree checks to make sure
  2792.      that the application identified by DVTXDI has the same title as the one
  2793.      it is working with, and, if so, only then does it consider it as the same
  2794.      application.  This title comparison is carried out to a length of 14
  2795.      characters only, as DV Tree uses character positions beyond 14 (if they
  2796.      are available) for loading in application file names.
  2797.  
  2798.  
  2799.  
  2800.  
  2801.                                  page -47-
  2802.  
  2803.  
  2804.      (O)pen Keys Change
  2805.  
  2806.              This option lets you change directly the Open Keys for which the
  2807.      F-Key is defined.  Any two character combination may be entered, and no
  2808.      check is made to ensure that the application is a valid one.  However, as
  2809.      long an alternate title has not been assigned to the key, DV Tree will
  2810.      respond by showing you the name of application if the Open Keys are
  2811.      available on DESQview's Open Menu, or ??-PIF.DVP in other cases.
  2812.  
  2813.              For advanced users with some sort of DESQview PIF editor, this
  2814.      option, (T)itle edit, and the .DVP path configuration option may be used
  2815.      to create and maintain a customized DV Tree setup without respect to the
  2816.      contents of DESQview's Open Menu.
  2817.  
  2818.  
  2819.  
  2820.  
  2821.      ┌────────────────────┐
  2822.      │  USING .EXT FILES  │                                            N2.3
  2823.      └────────────────────┘
  2824.  
  2825.              Version 2.3 (and above) of DV Tree allow you to associate multiple
  2826.      file extensions with a DESQview Function via a simple ASCII text file. To
  2827.      use this feature, you must use a text editor to create a file in DV Tree's
  2828.      home directory that contains the list of extensions.  The list should be
  2829.      formatted with one extension per line, and should contain no other data
  2830.      but the list.  For more information, please see the file SAMPLE.EXT.  Once
  2831.      you have created the file, use the (A)ssign .EXT File option from the
  2832.      DESQview Functions edit menu to establish the link.
  2833.  
  2834.              You may view this feature as an extension of the %X??? special
  2835.      action code (see Appendix A).  Both types of specifications are supported,
  2836.      but %X takes priority; in other words, when you hit (E)xec, all code
  2837.      strings are scanned for a matching extension in %X??? codes before any
  2838.      .EXT file data is searched.
  2839.  
  2840.  
  2841.  
  2842.                                      Part 4:
  2843.                               DV Tree Customization
  2844.                               ---------------------
  2845.  
  2846.      ┌────────────────────────────────┐
  2847.      │  CONFIGURATION (ZPECIAL MENU)  │
  2848.      └────────────────────────────────┘
  2849.  
  2850.  
  2851.      The following is an explanation of the items you can customize through the
  2852.      DV Tree's Configuration menu:
  2853.  
  2854.  
  2855.      DESQ Directory
  2856.  
  2857.              This should be the directory where DESQview keeps its own files.
  2858.      (default is C:\DV).  A drive specifier is required.  This path
  2859.      specification is what DV Tree uses to find DESQview's DESQVIEW.DVO file
  2860.      (which contains the Open Window list.)
  2861.  
  2862.  
  2863.      .DVP Directory
  2864.  
  2865.              You should generally set this option identically to the DESQ
  2866.      directory.  It exists primarily for non-standard configurations in which
  2867.      PIF files are maintained in a separate directory for ease of backup or
  2868.      other reasons.
  2869.  
  2870.  
  2871.      File # Max
  2872.  
  2873.              This value controls the maximum number of files in a directory
  2874.      that DV Tree is prepared to handle.  Possible values are 1 to 999, and the
  2875.      default is 200.  On an attempt to access a directory with more files than
  2876.      this limit, an error message is displayed, and the file list available to
  2877.      you is truncated.  Operations may then proceed as normal, but not all
  2878.      files will be available in the list.   When running in split screen, this
  2879.      number is effectively cut in half for each side of the split.
  2880.  
  2881.  
  2882.      Tree Size Max
  2883.  
  2884.              This value controls the maximum number of directories per drive
  2885.      that DV Tree is prepared to handle.  Default is 100.  An attempt to access
  2886.      a tree on a drive whose directory count exceeds this limit will fail.
  2887.  
  2888.  
  2889.      Exec K Addition
  2890.  
  2891.              This is the value added to the size the pointed-at file to get the
  2892.      memory size value for new window when you use the (E)xec or @(E)xec
  2893.      commands.  The default is 64k.
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.                                  page -49-
  2900.  
  2901.      Minimum Exec K
  2902.  
  2903.              This is the value that is used for (E)xec and @(E)xec if it is
  2904.      larger than the results of the normal (file size + 64K) equation.  The
  2905.      default is 128K.  You may want to increase this value if you want to use
  2906.      (E)xec to start large programs via small batch (.BAT) files.
  2907.  
  2908.  
  2909.      Restore Defaults
  2910.  
  2911.              This option resets DV Tree's color scheme (see section COLOR
  2912.      CUSTOMIZATION), all global options (see section GLOBALS SAVE/VIEW), and
  2913.      all of the above options back to their stated default values.  You will be
  2914.      asked to verify your request before the restoration of defaults occurs.
  2915.  
  2916.  
  2917.  
  2918.  
  2919.      ┌───────────────────────┐
  2920.      │  COLOR CUSTOMIZATION  │                                  N2.1
  2921.      └───────────────────────┘
  2922.  
  2923.              Two separate and distinct methods are available for managing the
  2924.      appearance of DV Tree's windows on color systems; the difference lies in
  2925.      whether the PIF of the DV Tree window has 'Uses own colors?' set to 'Y' or
  2926.      'N' (This is one of the fields at the bottom of page 2 of the Add/Change a
  2927.      Program displays.)
  2928.  
  2929.      Method 1:  (Uses own colors = N)     (REQUIRED for monochrome systems)
  2930.  
  2931.              This value in the PIF tells DESQview it has complete control over
  2932.      the colors in DV Tree, and the window colors you see result from the four
  2933.      combinations configured in DESQview's Advanced Setup.  Once the window is
  2934.      active, the colors may be changed via DESQview's Rearrange/Colors
  2935.      facility; DV Tree's Adjust Color feature will have absolutely no effect.
  2936.  
  2937.      Method 2:  (Uses own colors = Y)
  2938.  
  2939.              This value in the PIF lets DV Tree take over.  By default, the
  2940.      various DV Tree windows will have a blue on white color scheme, but this
  2941.      may easily be modified.  To change the colors, issue the (Z)pecial main
  2942.      screen command and select (A)djust Colors.  The program responds by
  2943.      popping up the tree window, then a small work window.  Using the cursor
  2944.      keys, you can scroll through all available color combinations in the
  2945.      current palette.  Using the number keys 1, 2, and 3, you can redirect the
  2946.      effect of the cursor keys between the three windows.  When you are
  2947.      satisfied with the colors, hit ESC.  DV Tree will ask if you want to save
  2948.      the new values, and if you respond with Y, your color settings will be
  2949.      stored in DV Tree's configuration file and remembered on subsequent
  2950.      executions.
  2951.  
  2952.  
  2953.  
  2954.  
  2955.                                  page -50-
  2956.  
  2957.              If you haven't modified the default installation PIFs that came
  2958.      with DV Tree, this is how color should work on your system. After you've
  2959.      changed the colors, if a copy of DV Tree is run in a window with Uses own
  2960.      colors = N, your color settings will be ignored.  You should also know
  2961.      that DV Tree has no way of knowing of any color changes you may make using
  2962.      DESQview's Rearrange/Colors, so (A)djust Colors cannot save them unless
  2963.      you use it to set them.
  2964.  
  2965.              A final, general note on DESQview and color:  DESQview specific
  2966.      applications like DV Tree can be very dependent on DESQview itself being
  2967.      configured with reasonable color scheme.  Colors for programs running with
  2968.      Uses own color = N are entirely dependent on reasonable combinations
  2969.      configured by the Advanced Setup for DESQview.  DESQview specific programs
  2970.      are also, regardless of the Uses own color setting, highly sensitive to
  2971.      settings in the DESQview color palette.
  2972.  
  2973.              With recent releases of DESQview, Quarterdeck Office Systems has
  2974.      bundled a small 'companion' program called DESQview Palette (DVPAL.COM).
  2975.      This program is not documented in the DESQview Version 2 manual, and it's
  2976.      mentioned only briefly in upgrade booklets, but it comes with a ready-made
  2977.      PIF that you can add to the Open Menu if you tell Add a Program to look in
  2978.      the main DESQview directory.  Through DVPAL it is possible to customize
  2979.      the standard set of sixteen colors available to DV Tree, thus further
  2980.      enhancing the color scheme of the display.  One of the most practical
  2981.      things possible with DVPAL is a modification of the color for highlighted
  2982.      black, since by default highlighted black looks little different than
  2983.      standard black, and this has an especially detrimental effect on attempts
  2984.      to setup DV Tree with black characters on any background.  Changing
  2985.      highlighted black to something like yellow or gray vastly increases the
  2986.      usefulness of DV Tree's (A)djust Colors command.
  2987.  
  2988.  
  2989.  
  2990.  
  2991.      ┌────────────────────────────┐
  2992.      │  THE CONFIGURABLE TOGGLES  │
  2993.      └────────────────────────────┘
  2994.  
  2995.              Most DV Tree commands that you find on Ctrl- key combinations are
  2996.      configurable toggles.  Alternating uses of a toggle turn it on and off,
  2997.      and when you use a toggle, the new setting is shown via an informational
  2998.      message.  These commands are set up this way because they are
  2999.      'configuration-like' - that is, they apply more to how the program works,
  3000.      than to any operation you might want to perform - but they are also
  3001.      features that you might want to occasionally have on, but at other times
  3002.      have off.
  3003.  
  3004.              See the next section to learn how the settings of these toggles
  3005.      may be saved and 'remembered' in DV Tree's configuration file.
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.                                  page -51-
  3012.  
  3013.      ^A
  3014.  
  3015.              With this toggle on, every time DV Tree becomes the foreground
  3016.      application, it will reread its displayed directory or directories.  This
  3017.      toggle makes permanent the effect available via the %r DV Function code
  3018.      and the DVTUPDAT utility in the UTILITY.ZIP archive.  Initial default is
  3019.      OFF.
  3020.  
  3021.  
  3022.      ^C
  3023.  
  3024.              When on, this toggle has an effect only in split screen - on
  3025.      copy/move operations, DV Tree will assume the directory in the opposite
  3026.      split to be the desired destination. Identical to hitting C or M followed
  3027.      immediately by the TAB key.  Initial default is OFF.
  3028.              Please note that the way ^C is set has a bearing on the function
  3029.      of the ^Q toggle as well - see ^Q for more information.
  3030.  
  3031.  
  3032.      ^F
  3033.  
  3034.              Toggles DESQview field marks (the '»' mark preceding selected
  3035.      fields) on/off.  Initial default is ON.
  3036.  
  3037.  
  3038.      ^T
  3039.  
  3040.              Toggles alphabetical sorting of trees during build/rebuild
  3041.      operations.  Initial default is ON.  As of release 1.8.2, adds are placed
  3042.      at the bottom of the tree, and renamed directories are not moved.
  3043.      Rebuilding the tree with this toggle on will reinstate the current alpha
  3044.      sort order.  Note: 'Klipped' subdirectories will always show at the bottom
  3045.      of their respective branches in a sorted tree.
  3046.  
  3047.  
  3048.      ^D   (show subdirectories)                                  N2.1
  3049.  
  3050.              With the ^D toggle on, DV Tree's file display will show entries
  3051.      for the parent directory (<..>), and any subdirectories of the viewed
  3052.      directory.  These entries cannot be marked; 'selecting' them, however,
  3053.      will effectively change directories.  Initial status is OFF.
  3054.  
  3055.      Notes:
  3056.  
  3057.              1)  If you select a directory entry that is not in the tree (i.e.
  3058.      you've created it outside of DV Tree since the last time the tree was
  3059.      rebuilt), an automatic rebuild of the tree will be forced.
  3060.  
  3061.              2)  If you select a directory entry that is klipped, the
  3062.      'Unklipped!' will automatically be activated.
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.                                  page -52-
  3069.  
  3070.  
  3071.      ^E   (expert keys)                                          N2.3 (N2.2)
  3072.  
  3073.              ^E is a toggle for experienced DV Tree users that eliminates some
  3074.      of the informational messages and question/answer dialogs DV Tree produces
  3075.      while running.  It has the following specific effects:
  3076.  
  3077.              - The Q&A to confirm the (M)ove command is bypassed.
  3078.              - the Q&A to confirm the Tree (K)lip command is bypassed.
  3079.              - The toggle status info window after changes of toggle status is
  3080.      never shown.  Note that the status off all toggles is available on the
  3081.      Z-(G)lobals save/view screen (see next section).  Initial status is OFF.
  3082.  
  3083.  
  3084.      ^Q   (quik floppies)                                        N2.3 (N2.2)
  3085.  
  3086.              This toggle is provided to improve the flexibility of tree
  3087.      operations, especially regarding copy/move.  The default setting of this
  3088.      toggle is ON, but for users upgrading from DV Tree 2.1, it will be OFF.
  3089.  
  3090.              The ^Q toggle controls how DV Tree handles disks with no directory
  3091.      structures (these will usually be floppy diskettes.)  With ^Q ON, the
  3092.      following occurs:
  3093.  
  3094.              1)  Copies to 'no-directory' disks will bypass the tree, making
  3095.      such copies a one- or two- step operation, depending on the status of the
  3096.      ^C toggle.
  3097.  
  3098.              2)  Selecting a 'no-directory' drive from the (T)ree-(S)witch menu
  3099.      will bypass the tree.
  3100.  
  3101.              3)  Copies from a 'no-directory' drive will go immediately to the
  3102.      (S)witch menu.
  3103.  
  3104.              Since the above three actions generally represent 'logical' next
  3105.      steps, most people will want to run with ^Q on.  If, however, you keep the
  3106.      ^C (auto copy) ON on a normal basis, you may want to turn ^Q OFF.  In any
  3107.      event, it's all a matter of taste, as shown in the following configuration
  3108.      combinations:
  3109.  
  3110.              Configuration 1:  ^C OFF  ^Q ON  (default and 'old way')
  3111.              - copy/move brings up a tree positioned to the current directory.
  3112.              - TAB selects the opposite split.
  3113.              - If dest is a 'no-directory' drive, copy/move begins, otherwise,
  3114.                Enter causes copy/move to proceed.
  3115.  
  3116.              Configuration 2:  ^C ON   ^Q OFF
  3117.              - copy/move brings up a tree positioned to the opposite directory.
  3118.              - Enter causes copy/move to proceed.
  3119.  
  3120.  
  3121.  
  3122.  
  3123.                                  page -53-
  3124.  
  3125.              Configuration 3:  ^C ON   ^Q ON
  3126.              - If dest is a 'no-directory' drive, copy/move begins immediately.
  3127.              - (otherwise, like configuration 2).
  3128.  
  3129.              Configuration 4:  ^C OFF  ^Q OFF
  3130.              - copy/move brings up a tree positioned to the current directory.
  3131.              - TAB selects the opposite split.
  3132.              - Enter causes copy/move to proceed.
  3133.  
  3134.  
  3135.  
  3136.  
  3137.      ┌─────────────────────┐
  3138.      │  GLOBALS SAVE/VIEW  │                                     N2.1
  3139.      └─────────────────────┘
  3140.  
  3141.  
  3142.              As its name implies, the Globals Save/View (Z-G from the main
  3143.      screen) display serves two purposes.  You can use it to see the settings
  3144.      of all the configurable toggles and other 'global' options at once, and
  3145.      you can also use it to make these options permanent so that DV Tree will
  3146.      have them set this way each time you start it.
  3147.  
  3148.              The options that are saved include:
  3149.  
  3150.              All configurable toggles.
  3151.              The current main screen sort options.
  3152.              The current Mas(K) mask.
  3153.              The current (F)ind date.
  3154.              The current split screen direction.
  3155.  
  3156.              (To see how to make split screen itself permanent, see the OPP=*
  3157.      parameter in the COMMAND LINE OPTIONS section.)
  3158.  
  3159.  
  3160.  
  3161.  
  3162.      ┌─────────────────────────────────┐
  3163.      │  THE DIRECTORY HOT-KEY FEATURE  │
  3164.      └─────────────────────────────────┘
  3165.  
  3166.  
  3167.              In DV Tree, numeric keys 1 through 0 (8,9,0) are 'directory
  3168.      hot-keys'. Once you assign a hot-key, you may 'jump' to it in either the
  3169.      main or tree displays by simply hitting the key.
  3170.  
  3171.              The purpose of this command is to give you a way to quickly move
  3172.      to your 'favorite' directories from anywhere else in your system.  To
  3173.      assign a key:  select the directory through normal tree navigation, then
  3174.      press @ (Alt) in combination with the numeric key (important:  use the
  3175.  
  3176.  
  3177.  
  3178.                                  page -54-
  3179.  
  3180.      number keys on the top row of the 'typewriter' keyboard, not the keypad
  3181.      number keys.)  If the chosen numeric key is already assigned, you will be
  3182.      warned before the definition is replaced.
  3183.  
  3184.              To check your hot-key assignment, key Z, then S from the main
  3185.      display.  You can also unassign a key, if you wish, from this display.
  3186.  
  3187.              Now that you've made an assignment, you can get back to the
  3188.      directory from anywhere by just hitting the numeric hot-key (the keypad is
  3189.      okay for this now.)  You can even select your assigned directory as the
  3190.      destination for a copy/move operation from anywhere just by hitting the
  3191.      hot-key.
  3192.  
  3193.  
  3194.      ^Left/^Right  (more commands!)
  3195.  
  3196.              ^Left and ^Right give you another kind of 'hot-key' - they may
  3197.      normally be used to 'cycle' the file display through the last few
  3198.      directory/drive combinations you've worked from.  DV Tree maintains up to
  3199.      a maximum of four destinations for this feature.
  3200.  
  3201.  
  3202.  
  3203.      ┌───────────────────────────┐
  3204.      │  DIRECTORY CUSTOMIZATION  │
  3205.      └───────────────────────────┘
  3206.  
  3207.              DV Tree offers a feature called Directory Customization based on
  3208.      the idea that file directories often contain different types of data, and
  3209.      you may therefore often wish to arrange these types of data in different
  3210.      ways, primarily with respect to sort options.  For instance, you might
  3211.      always want to see a directory containing a large number of reference
  3212.      documentation files sorted alphabetically, regardless of the global sort
  3213.      options currently in effect.  Likewise, the source code directories of a
  3214.      programmer - or the document directories of a writer - might best be
  3215.      viewed in descending date/time sequence.
  3216.  
  3217.              Through Directory Customization, this is easily possibly.  Once
  3218.      customization is chosen, a small file in saved in the directory in
  3219.      question and then used by DV Tree on subsequent accesses.  Options saved
  3220.      are: (S)ort options and directions, and (I)ncl and Mas(K) masks.
  3221.  
  3222.              To customize a directory, type Z from DV Tree's main screen, then
  3223.      (K)ustomize Directory.  You will see the options DV Tree is prepared to
  3224.      save with respect ONLY to the current directory.  To proceed with
  3225.      customization, select 'Customize Directory'.  You can also use this screen
  3226.      to delete customization for the current directory (if it exists.)
  3227.  
  3228.              When directory customization is in effect, the word "Sort" above
  3229.      the 'Status' line on the display is replaced by "Cust".
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.                                  page -55-
  3236.  
  3237.      + (the plus key)
  3238.  
  3239.              Yes, this is yet another command!  The plus key, on the main
  3240.      display, gives you a way to quickly toggle directory customization on and
  3241.      off for a customized directory you are currently viewing.  (The 'parallel'
  3242.      of this command on the tree screen is the 'klipped/unklipped' tree toggle,
  3243.      also on the + (plus) key.)
  3244.  
  3245.              A final note:  When a directory is customized, a small file is
  3246.      saved in that directory under the name DVTREE.DAT.  If this file is
  3247.      deleted, either manually or by choosing 'Delete Customization' from the
  3248.      directory customization menu, the customization information will be lost.
  3249.  
  3250.  
  3251.  
  3252.  
  3253.      ┌────────────────────────┐
  3254.      │  COMMAND LINE OPTIONS  │
  3255.      └────────────────────────┘
  3256.  
  3257.  
  3258.      DV Tree will accept the following options on its command line (i.e., the
  3259.      Parameters: field of the Change A Program menu.)
  3260.  
  3261.  
  3262.      TREE=d:\fspec\filename
  3263.  
  3264.              This option can be used to tell DV Tree where to find it's files
  3265.      if your DV Tree directory is not c:\dv\dvtree, d:\dv\dvtree, or
  3266.      e:\dv\dvtree.  (You can also do this with the TREE environment variable -
  3267.      see the section RUNNING DV TREE FROM DOS)
  3268.  
  3269.  
  3270.      FMAX=nnn
  3271.  
  3272.              This option may be used to override the Maximum # of files value
  3273.      in DV Tree's configuration file.  This option (and TMAX=nnn) give you a
  3274.      way to customize multiple DV Tree PIFs for different memory needs. See
  3275.      also PERFORMANCE NOTES.
  3276.  
  3277.  
  3278.      TMAX=nnn
  3279.  
  3280.              This option may be used to override the Maximum # of directories
  3281.      per drives value set in DV Tree's configuration file.  See also
  3282.      PERFORMANCE NOTES.
  3283.  
  3284.  
  3285.      RESET
  3286.  
  3287.              This parameter instructs DV Tree to destroy all previously built
  3288.      tree files and the DVTREE.CNF file (a last resort in cases when the
  3289.  
  3290.  
  3291.  
  3292.                                  page -56-
  3293.  
  3294.      program malfunctions due to inadvertently corrupted control files.)  The
  3295.      command is confirmed before DV Tree proceeds.  This option should not be
  3296.      placed in program PIF files - it should only be passed to the program by
  3297.      executing DV Tree from the DOS command line in a general-purpose DOS
  3298.      window.
  3299.  
  3300.  
  3301.      EXEC=S / EXEC=E                                             N2.1
  3302.  
  3303.              These parameters on the DV Tree command line allow you to change
  3304.      the assignment of the (E)xec command from the E key to either the ENTER
  3305.      key (EXEC=E) or the space bar (EXEC=S).
  3306.  
  3307.  
  3308.      OPP=d:\filespec                                             N2.1
  3309.  
  3310.              This option provides a way to automatically enter split screen
  3311.      mode and select a different subdirectory for display in the opposite side
  3312.      of the split at startup.  Useful if you have more than one favorite place
  3313.      to begin work from.  To just come up in split screen, use OPP=*.
  3314.  
  3315.              Related Tip:  To control DV Tree's startup directory, place the
  3316.      filespec of the directory you first wish to see when DV Tree starts in the
  3317.      Directory: field in DV Tree's PIF by using Change a Program.
  3318.  
  3319.  
  3320.      DISP=n                                                      N2.3 (N2.2)
  3321.  
  3322.              This option gives you control over how DV Tree displays file
  3323.      names.  By default, file names are shown contiguously in lower case with
  3324.      their extensions attached.  The following are possible:
  3325.  
  3326.              DISP=1     ...causes file names to show in upper case.
  3327.              DISP=2     ...shows extensions in columns (ala DOS DIR).
  3328.              DISP=3     ...DISP=1 + DISP=2.
  3329.  
  3330.  
  3331.      NOHOP                                                       N2.3
  3332.  
  3333.              This option disables the automatic directory and jump feature of
  3334.      the = (jump) commands.  Available for compatibility with scripts, and for
  3335.      anyone who doesn't like the blinking mouse cursor.
  3336.  
  3337.  
  3338.      TROOT                                                       N2.3
  3339.  
  3340.              This option causes DV Tree to create and maintain DVTREE_? (the
  3341.      tree files) in the root directories of all hard drives (rather than in the
  3342.      DV Tree 'home' directory).  Functionally, it gives network users a way to
  3343.      maintain common tree files, but separate macro, hot-key, and other files.
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.                                  page -57-
  3350.  
  3351.  
  3352.  
  3353.      ┌───────────────────────────────────────────┐
  3354.      │  RUNNING DV TREE IN EGA/VGA HI-RES MODES  │
  3355.      └───────────────────────────────────────────┘
  3356.  
  3357.              If you normally run in EGA 43 line, or VGA 50 line modes, you may
  3358.      experience problems when from time to time when DV Tree becomes the
  3359.      foreground application (specifically, you're suddenly kicked back into 25
  3360.      line mode.)  You can defeat this effect by changing the PIF for DV Tree
  3361.      using Change a Program and setting DV Tree's maximum AND starting window
  3362.      sizes to 43x80 or 50x80.  (This advice from READ.ME, DV 2.26.)
  3363.  
  3364.              The only thing you lose by doing this is a little bit of memory,
  3365.      plus the technique used in the TZ version of DV Tree (DESQview Tree
  3366.      (Pop-Up)) of putting 22x30 in the starting window size to get the small
  3367.      window.  You can overcome this, however, by 'Learning' a !Startup script
  3368.      for DV Tree that uses DESQview's Rearrange/Resize feature to set whatever
  3369.      window size you desire each time you start the DV Tree window.  If you're
  3370.      unsure how to create this script, see the section on Learn in your
  3371.      DESQview manual.
  3372.  
  3373.  
  3374.  
  3375.  
  3376.      ┌────────────────────────────┐
  3377.      │  RUNNING DV TREE FROM DOS  │
  3378.      └────────────────────────────┘
  3379.  
  3380.              DV Tree provides you with two extra facilities to aid in running
  3381.      DV Tree from the command line in a general purpose (non-Writes Directly to
  3382.      Screen) DOS window:
  3383.  
  3384.  
  3385.      The TREE Environment Variable
  3386.  
  3387.              If you plan to run DV Tree from DOS often, and your DV Tree
  3388.      directory is not c:\dv\dvtree, d:\dv\dvtree, or e:\dv\dvtree, you will
  3389.      probably want to use the TREE environment variable so DV Tree can figure
  3390.      out where to find its files.  The environment variable can be set in a
  3391.      batch file or from the command line with the following command:
  3392.  
  3393.      SET TREE=D:\DV31\DVTREE
  3394.  
  3395.              You of course should replace d:\dv\dv31\dvtree with the full
  3396.      filespec to the DV Tree directory on your system.
  3397.  
  3398.  
  3399.      @(Q)uit                                                     NIOS
  3400.  
  3401.              @Q is a variation on the (Q)uit command - the differences are that
  3402.      it doesn't ask you if you're sure, and it will 'quit' into the directory
  3403.  
  3404.  
  3405.  
  3406.                                  page -58-
  3407.  
  3408.      that is currently visible in the display.
  3409.  
  3410.  
  3411.  
  3412.  
  3413.      ┌─────────────────────┐
  3414.      │  PERFORMANCE NOTES  │
  3415.      └─────────────────────┘
  3416.  
  3417.              1)  The program information files included with DV Tree assume the
  3418.      default values of file max and tree max to be in effect.  If the values
  3419.      are increased (via the FMAX/TMAX command line options, or internally
  3420.      through configuration), DV Tree's memory size values (both normal and
  3421.      system) may need to be increased using Change A Program.  Conversely, a
  3422.      decrease in the values may allow the memory sizes to be decreased - DV
  3423.      Tree's memory usage can therefore be fine-tuned to an individual
  3424.      environment's requirements.  In general, you can depend on the system
  3425.      displaying messages when an increase in values is required.  For both
  3426.      program and system memory, gradual boosts by 1 or 2 K until the complaints
  3427.      stop are recommended.
  3428.  
  3429.              2)  When modifying normal memory via Change a Program, care should
  3430.      used to avoid going overboard.  Any memory amount specified beyond about
  3431.      116K will be wasted - this is the absolute limit of what the program can
  3432.      use.
  3433.  
  3434.              3)  In a cramped environment, copy/move operations use only a
  3435.      small 4K buffer, therefore these procedures may take longer on large files
  3436.      than other file copy methods.  If memory is available, DV Tree acquires a
  3437.      larger buffer for copy/move operations, and you can tell the size of this
  3438.      buffer by watching a copy/move of a large file.
  3439.  
  3440.  
  3441.  
  3442.  
  3443.      ┌───────────────────────┐
  3444.      │  NETWORK USAGE NOTES  │
  3445.      └───────────────────────┘
  3446.  
  3447.              To the author's knowledge, DV Tree is compatible with all
  3448.      available network software.  However, very large networks may have
  3449.      directory structures that are simply too large for the program to handle
  3450.      in any configuration.  For users in a such a situation, DOS's SUBST may
  3451.      provide some remedy.
  3452.  
  3453.              On the positive side, DV Tree's TROOT command line option may be
  3454.      used to keep one copy of a tree file in the root directory of each drive
  3455.      so that it may be accessed by all users.  With version 2.3, DV Tree will
  3456.      recognize when a tree file has been updated by another user or process and
  3457.      reload it where possible.  It should also protect against one user
  3458.      'undoing' another's update by asking whether it should proceed under such
  3459.      circumstances.
  3460.  
  3461.  
  3462.  
  3463.                                    Appendix A:
  3464.                          DESQview Function Codes Reference
  3465.                          ---------------------------------
  3466.  
  3467.  
  3468.      This Appendix is intended as a detailed reference source for the various
  3469.      codes that may be used in code strings for DV Functions.  The codes are
  3470.      grouped and covered in order by the following categories:
  3471.  
  3472.  
  3473.              MAJOR CODES
  3474.              STRING REPLACEMENT CODES
  3475.              SPECIAL STRING REPLACEMENT CODES
  3476.              'PIF' DIRECTORY CODES
  3477.              SPECIAL KEYSTROKE CODES
  3478.              SCRIPT INITIATION CODES
  3479.              DELAY CODES
  3480.              SPECIAL ACTION CODES
  3481.              'HIDDEN' DESQVIEW FEATURE CODES
  3482.  
  3483.  
  3484.      ┌───────────────┐
  3485.      │  MAJOR CODES  │
  3486.      └───────────────┘
  3487.  
  3488.      %c      Denotes command line input.  All following characters and strings
  3489.              from replacement codes will be placed on the application's command
  3490.      line at startup.  For any application that accepts a filename as its
  3491.      primary input on the DOS command line, all that is usually needed for the
  3492.      %c code is %c%p.
  3493.  
  3494.  
  3495.      %k      Denotes keystroke input at startup.  All following characters and
  3496.              strings from replacement codes will be 'typed' into the
  3497.      application at startup.  This code may often need to be followed
  3498.      immediately by a delay code (&1-&9) in order to give the application time
  3499.      to initiate to a certain point.  If the application requires 'unusual'
  3500.      keystroke input to load a file or switch to a directory, a script
  3501.      initiation code (&z-&v) may be necessary.  Also, and very importantly, you
  3502.      must have enough memory in your system for DV Tree to remain resident
  3503.      (i.e. the starting program may not force DV Tree to be "swapped to disk".)
  3504.      If sufficient memory is not available, an attempt to initiate the
  3505.      application will produce an error message.
  3506.  
  3507.  
  3508.                                                                  N2.1
  3509.      %A      %A is much like %k, except that it applies only if the application
  3510.              is currently running (DV Tree 'knows' that it is running either
  3511.      through DVTXDI, or the fact that it started it earlier in the computing
  3512.      session.)  Rather than start a new copy of the application, %A causes DV
  3513.      Tree to 'type' the following characters and strings into the active
  3514.      application.  A delay code may often be necessary, and a script
  3515.      initiation will ALMOST ALWAYS be necessary.  Important note:  %A will be
  3516.      always be overridden by the %+ special action code.
  3517.  
  3518.  
  3519.  
  3520.                                  page -60-
  3521.  
  3522.  
  3523.      Every code string MUST begin with the %c code or the %k code.  Beyond
  3524.      that, the three major codes may be 'mixed' in the code string in any
  3525.      fashion or order.  The rule is that normal characters, string replacement
  3526.      codes, delay codes, and script initiation codes apply only to the previous
  3527.      major code.
  3528.  
  3529.  
  3530.  
  3531.  
  3532.      ┌────────────────────────────┐
  3533.      │  STRING REPLACEMENT CODES  │
  3534.      └────────────────────────────┘
  3535.  
  3536.      The primary objective of a DESQview Function code string is to allow DV
  3537.      Tree to load files into other DESQview Applications, and the string
  3538.      replacement codes are the 'heart' of this process.
  3539.  
  3540.      %p      Expands into the full DOS filespec of the pointed-at file.  This
  3541.              is probably the most important code of all.
  3542.  
  3543.      %s      Expands into the (12-character) filename of the pointed-at file.
  3544.              It may often be a good idea to use %s along with %D PIF directory
  3545.              code instead of %p (for one thing, it can drastically shorten
  3546.              the length of the command line.)
  3547.  
  3548.      %x      Expands into the filename minus the extension of the pointed-at
  3549.              file.
  3550.  
  3551.      %y      Expands into the file extension of the pointed-at file.
  3552.  
  3553.      %n      Expands into the full DOS filespec minus the drive specifier of
  3554.              the pointed-at file.  (For programs that don't like drive
  3555.              qualifiers.)
  3556.  
  3557.      %d      Expands into the full DOS filespec of the current directory.  %d
  3558.              (also %o and %i below) provides a way to set up a DESQview
  3559.              Function at the directory level.
  3560.  
  3561.      %o      Expands into the full DOS filespec minus the drive specifier
  3562.              of the current directory.  (Again for programs that don't like
  3563.              drive qualifiers.)
  3564.  
  3565.                                                                  N2.1
  3566.      %i      Expands into the DV Tree (I)ncl mask for the current directory.
  3567.              (example:  %d\%i will result in the current directory, a slash,
  3568.              and the (I)ncl mask.)
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.                                  page -61-
  3577.  
  3578.      ┌────────────────────────────────────┐
  3579.      │  SPECIAL STRING REPLACEMENT CODES  │
  3580.      └────────────────────────────────────┘
  3581.                                                                  N2.1
  3582.      %@      Expands into the full pathname (or possibly a single filename) of
  3583.              the file containing a list of all files marked in the current
  3584.      display.  This is also a special action code - please refer to the more
  3585.      detailed explanation in the special action codes section below.
  3586.  
  3587.  
  3588.      %?      Allows you to insert variable text input (such as an output
  3589.              filename for an archival program like PKZIP).  The window
  3590.      presented allows you to key 20 characters, and your input will be 'pasted'
  3591.      into the string at the position where %? occurs.
  3592.  
  3593.  
  3594.                                                                  N2.1
  3595.      %Qnn    (where nn = 01 - 99)  %Q is a 'customizable' %? and acts in much
  3596.              the same way except that the input window is 'nn' positions long.
  3597.      Please note that 'nn' is two characters long, so to get an 8 character
  3598.      window, the code would be %Q08.
  3599.  
  3600.  
  3601.  
  3602.  
  3603.      ┌─────────────────────────┐
  3604.      │  'PIF' DIRECTORY CODES  │
  3605.      └─────────────────────────┘
  3606.  
  3607.      These codes cause a value to be placed in the Directory.: field of the
  3608.      application's PIF at startup (just as if you had placed it there via Add/
  3609.      Change a Program.)  This field controls the DOS directory that the
  3610.      application perceives as its current directory.
  3611.  
  3612.  
  3613.      %D      Puts the directory filespec of the current directory in the
  3614.              directory area of the starting PIF.
  3615.  
  3616.      %O      Puts the directory filespec associated with THE OPPOSITE side of a
  3617.              DV Tree split screen in the directory area of the starting PIF.
  3618.      If the screen is not split, %O will have no effect (therefore, you can
  3619.      make it default to the current directory when not in split screen if you
  3620.      like by leaving the Directory.: field blank on the Change A Program screen
  3621.      (refer to note 1 below).
  3622.  
  3623.      Notes:
  3624.  
  3625.           1)  If the Directory.: field in the PIF is left blank, DV Tree will
  3626.               AUTOMATICALLY assume a %D code (unless %O).
  3627.           2)  Some programs with lots of data files will not like either of the
  3628.               codes (these are programs that require you to start them from
  3629.               a specific directory.)
  3630.  
  3631.  
  3632.  
  3633.                                  page -62-
  3634.  
  3635.           3)  These codes, combined with string replacement codes, can create
  3636.               subtly different effects:
  3637.  
  3638.               Example A:  %c%p
  3639.               Example B:  %c%s%D
  3640.  
  3641.      Assume these codes assigned to an ASCII text editor that accepts command
  3642.      line input in a 'normal' way, and the PIF's Directory.: = c:\work, and you
  3643.      start the application by hitting it's associated F-Key while DV Tree is
  3644.      pointing at c:\dos\startup.bat.  In both cases, you would find yourself
  3645.      editing startup.bat, but if the text editor has a 'shell to DOS' feature,
  3646.      in example A you would find yourself in the directory c:\work, while in
  3647.      example B you would be in c:\dos.  On the other hand, if you took c:\work
  3648.      out of the directory field of the PIF, the effects of the two examples
  3649.      would be identical (and a shell to DOS would put you in c:\dos.)
  3650.  
  3651.  
  3652.  
  3653.  
  3654.      ┌───────────────────────────┐
  3655.      │  SPECIAL KEYSTROKE CODES  │
  3656.      └───────────────────────────┘
  3657.  
  3658.      %e      Effects an 'Enter' keystroke.
  3659.  
  3660.      %E      Effects an 'ESC' keystroke.
  3661.  
  3662.      %%      Inserts a single % (percent) sign.
  3663.  
  3664.      &&      Inserts a single & (ampersand) sign.                N2.1
  3665.  
  3666.  
  3667.  
  3668.      ┌───────────────────────────┐
  3669.      │  SCRIPT INITIATION CODES  │                               N2.1
  3670.      └───────────────────────────┘
  3671.  
  3672.      &z      This is a special and powerful keystroke code for use with the %k
  3673.              and %A major codes.  &z provides a way for any combination of
  3674.      keystrokes to be sent to an application by exploiting DESQview scripts, or
  3675.      the Learn feature.  This script may do almost anything a 'normal'
  3676.      DESQview script can do - that is, it can 'play back' recorded sequences
  3677.      of function keys, cursor keys, alt- keys, ctrl- keys, etc..  The only
  3678.      restriction on the script is that it may not enter a fixed- or variable-
  3679.      length pause and expect DV Tree to fill in the blanks (DESQview itself
  3680.      won't let this happen.)  &z will execute the {255} script in the target
  3681.      window.  See the section INTRODUCTION TO DESQVIEW FUNCTIONS for a
  3682.      step-by- step example of how to create a {255} script for any given
  3683.      application.
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.                                  page -63-
  3690.  
  3691.      &y-&v   These codes are identical to &z except they execute {254} - {251}
  3692.              (counting backwards:  &v = {251}.)  For some applications,
  3693.      different scripts may be needed to fill different needs (for example, a
  3694.      {255} script at program startup, but a {254} script to handle file reload
  3695.      situations.)
  3696.  
  3697.  
  3698.  
  3699.      ┌───────────────┐
  3700.      │  DELAY CODES  │
  3701.      └───────────────┘
  3702.  
  3703.      Delay codes are intended to give an application time to reach a point when
  3704.      it is ready to accept input.  Some applications actually flush a system's
  3705.      keyboard prior to waiting for a keystroke, and these sorts of applications
  3706.      will almost certainly require delay codes.  These codes make sense only in
  3707.      string segments following %k or %A.
  3708.  
  3709.      &n      (where n = 1 - 9):  Causes DV Tree to pause for 1 - 9 seconds
  3710.              when sending keystroke input to the started program.
  3711.  
  3712.                                                                  N2.1
  3713.      &.n     (where n = 1 - 9):  Exactly like &n, except the delay produced is
  3714.              of sub-second duration (i.e. %.5 results in a half second delay.)
  3715.  
  3716.  
  3717.      Note:  &1.5 is NOT valid.  (&1&.5 is)
  3718.  
  3719.  
  3720.  
  3721.  
  3722.      ┌────────────────────────┐
  3723.      │  SPECIAL ACTION CODES  │
  3724.      └────────────────────────┘
  3725.  
  3726.      These codes may be thought of as special directives to DV Tree to perform
  3727.      specific actions, and, with the exception of %@, they may appear anywhere
  3728.      in the code string.
  3729.  
  3730.                                                                  N2.1 (N2.3)
  3731.      %X???   (where ??? = a DOS file extension).  %X allows a linkage to be
  3732.              established between the F-Key and a given file extension (???).
  3733.      Hitting the 'E' (EXEC) key while pointing at a file with the ??? extension
  3734.      will activate the function just as if the function key itself had been
  3735.      hit.  For mouse users, this is an important code as it allows the mouse
  3736.      to activate a DESQview Function by clicking on EXEC.  Please note that the
  3737.      three positions in ??? are meaningful; an extension of less than three
  3738.      characters must be padded with blanks if the %X is not the last thing
  3739.      in the code string.  To specify a link to files with no extension, code
  3740.      %x.  (a . followed by two spaces).  To link a function key to more than
  3741.  
  3742.  
  3743.  
  3744.                                  page -64-
  3745.  
  3746.      one extension, see the section USING .EXT FILES.  A final note:  %Xbat,
  3747.      %Xcom, or %Xexe will 'override' the normal (E)xec command action for the
  3748.      extension in question.
  3749.  
  3750.  
  3751.      %+      This code tells DV Tree to automatically allow a second copy (or
  3752.              third, etc.) copy of the application to be started without asking
  3753.      questions.  Without this code (or %A), an attempt to start an already
  3754.      running application will result in a window titled "Appl Already Active!"
  3755.      that gives you the choice of making the currently running copy the
  3756.      foreground application, opening a second copy, or closing the existing
  3757.      copy first.  %+ absolutely negates the effect of any %A string.
  3758.  
  3759.  
  3760.      %q      Instructs DV Tree to immediately end execution after starting the
  3761.              application - this should generally allow the application to run
  3762.      in the same memory space held by DV Tree, avoiding DESQview initiated
  3763.      swaps to disk in very memory-constricted systems.  %q is only valid in a
  3764.      string following %c.
  3765.  
  3766.  
  3767.      %r      Activates DV Tree's automatic directory refresh feature.  The
  3768.              application will start normally and (most likely) become the
  3769.      foreground application in the system.  %r will have no effect until DV
  3770.      Tree again becomes the foreground application, at which time DV Tree will
  3771.      reread its displayed directory (or directories) from disk.  Please note
  3772.      that there are two other ways to make the same thing happen:
  3773.  
  3774.              1)  The utility program, DVTUPDAT.COM, run from another window
  3775.                  (for example, at the end of a batch file that compiles
  3776.                  and links programs in the background.)
  3777.  
  3778.              2)  The ^A configurable toggle which causes an update to
  3779.                  always occur when DV Tree comes foreground.
  3780.  
  3781.      The following enhancements to %r were made in V2.3:         N2.3
  3782.  
  3783.          -  By default, in split screen only one directory will be refreshed,
  3784.             allowing file marks in the opposite directory to be preserved.
  3785.             The affected directory will be the pointed-at directory *unless*
  3786.             the %O code appears before %r, in which case only the opposite
  3787.             directory will be reread.
  3788.          -  To force a dual directory refresh, code %rb
  3789.          -  Note: If the ^A (auto refresh) toggle is on, both directories will
  3790.             *always* be refreshed.
  3791.  
  3792.  
  3793.                                                                  N2.1
  3794.      %R      Disables DV Tree's automatic directory refresh feature on a one-
  3795.              time only basis.  This code is intended to provide a way to
  3796.      selectively defeat the effect of the ^A toggle.
  3797.  
  3798.  
  3799.  
  3800.  
  3801.                                  page -65-
  3802.  
  3803.  
  3804.                                                                  N2.1
  3805.      %Z      Is a powerful special action code that tells DV Tree to perform
  3806.              the function recursively against ALL marked files in the display.
  3807.      You will almost always want to use it in conjunction with the %A code for
  3808.      an applications capable of handling multiple files at once, (or possibly
  3809.      for a small application with the %+ code.)  The following examples are
  3810.      presented for Buerg's LIST program:
  3811.  
  3812.              %c%p%A&z%p%e%Z    This will allow you to start or reload LIST
  3813.                                with up to 10 files at once (LIST's maximum
  3814.                                is 10 files, so if you mark more than 10,
  3815.                                only the 'lowest' ten will be available.)
  3816.  
  3817.              %c%p%+%Z          This will start a copy of the LIST
  3818.                                application for each marked file.  Not
  3819.                                very recommended.
  3820.  
  3821.      If you've assigned %Z to an application, but no files are marked, %Z will
  3822.      be ignored and DV Tree will assume you want to initiate or reload the
  3823.      application with the single, pointed-at filename.
  3824.  
  3825.  
  3826.                                                                  N2.3 (N2.2)
  3827.      %P      Forces replacement of an existing PIF parameter line with DV
  3828.              Tree's generated command line.  Normally, DV Tree appends an
  3829.      existing PIF command line to the end of that generated by a code string.
  3830.      See also:  %J.
  3831.  
  3832.  
  3833.                                                                  N2.3 (N2.2)
  3834.      %J      Causes a DV Tree generated command line to be joined to the
  3835.              end of an existing PIF parameter specification.  This is exactly
  3836.      opposite to the normal default action.  See also:  %P.
  3837.  
  3838.  
  3839.                                                                  N2.3 (N2.2)
  3840.      %Mnnn   (where nnn = 3 digit numeric value).  This code replaces the
  3841.              memory in K specified in the PIF at application startup with nnn
  3842.      and is potentially useful in situations where you might want to assign
  3843.      multiple F-Keys to the same application for different purposes (such as
  3844.      one for editing small files, another for editing very big files).
  3845.      Example:  %M080.  See also:  %Nnnn.
  3846.  
  3847.  
  3848.                                                                  N2.3 (N2.2)
  3849.      %Nnnn   (where nnn = 3 digit numeric value).  This code replaces the
  3850.              memory in K specified in the PIF at application startup with nnn
  3851.      + the size of the pointed-at file, allowing for fine tuning of application
  3852.      memory usage based on input file characteristics.  %Nnnn can be
  3853.      particularly useful with editor applications.  See also:  %Mnnn.
  3854.  
  3855.  
  3856.  
  3857.  
  3858.                                  page -66-
  3859.  
  3860.  
  3861.                                                                  N2.3
  3862.      %L      Causes DV Tree to 'lock' this function key to its associated
  3863.              extension(s).  When this code is present and the F-Key is hit, an
  3864.      error message will be displayed if the pointed-at file's extension does
  3865.      not match the key's %X??? specification or an extension included in the
  3866.      optional .EXT file.  Useful for applications that should only be used
  3867.      against certain types of files.
  3868.  
  3869.  
  3870.                                                                  N2.3
  3871.      %T      Associates the F-Key's 'uniqueness' with its alternate title
  3872.              as well as its Open Keys.  This allows multiple F-Keys to be
  3873.      assigned to identical Open Keys with alternate titles and is particularly
  3874.      applicable to strings incorporating the %A code.
  3875.  
  3876.  
  3877.                                                                  N2.3
  3878.      %n      (where n = 0 - 9)  causes expansion of user macro code string n.
  3879.              Note:  If code string n is not defined, this code will have no
  3880.      effect.
  3881.  
  3882.  
  3883.                                                                  N2.1
  3884.      %@      Provides a way to produce a file containing a list of all marked
  3885.              files in the display.  %@ is specifically intended to support
  3886.      programs that accept an input file list, such as PKZIP.  By default, the
  3887.      'listfile' is created in the DV Tree home directory and contains the full
  3888.      pathnames of all marked files.  The name of the listfile is also expanded,
  3889.      so in this way it is also a string replacement code.  The following is an
  3890.      example for PKZIP:
  3891.  
  3892.              %c%Q08 @%@ %O%r
  3893.  
  3894.      This will:
  3895.  
  3896.              1)  Present an 8 character input prompt (%Q08) for the ZIP
  3897.                  filename.
  3898.              2)  Tell PKZIP to work on an input file list (@).
  3899.              3)  Write the file and insert the name (%@)
  3900.              4)  Put the output file in the opposite split directory (%O) if
  3901.                  the screen is split (else in the current directory if the
  3902.                  Directory.: field in PKZIP's PIF is blank).
  3903.              5)  Refresh DV Tree's display when DV Tree next comes foreground.
  3904.  
  3905.  
  3906.      The %@ code has the following additional features and restrictions in
  3907.      order to support other possible uses:
  3908.  
  3909.              1)  If no files are marked in the display, the file list will
  3910.                  be created with an entry for the pointed-at file.
  3911.  
  3912.  
  3913.  
  3914.                                  page -67-
  3915.  
  3916.              2)  %@%s    - This will cause the file list to contain only
  3917.                            12 character file names instead of full filespecs.
  3918.              3)  %@%x    - This will cause the file list to contain only
  3919.                            file names minus extensions.
  3920.              4)  The various possible %@ strings (%@, %@%s, and %@%x) may
  3921.                  be followed by a character string.  If present, DV Tree will
  3922.                  assume this string to be an alternate filename for the
  3923.                  file list itself (instead of c:\dv\dvtree\pipe.lst, the likely
  3924.                  default).  If the filename does not contain full path
  3925.                  information, it will be created in the current directory.
  3926.              5)  The %@ code, with or without the above subparameters, MUST
  3927.                  be followed by a space (or be at the end of the code string.)
  3928.  
  3929.  
  3930.  
  3931.  
  3932.      ┌───────────────────────────────────┐
  3933.      │  'HIDDEN' DESQVIEW FEATURE CODES  │
  3934.      └───────────────────────────────────┘
  3935.  
  3936.      The following are special action codes that exploit features of DESQview
  3937.      for which there is no option on the Change a Program menus (as of this
  3938.      writing.)
  3939.  
  3940.      %!n     (where n = 1 - 9):  The 'TAME' feature.  Through this code, you
  3941.              can tell DESQview to give control of the processor to other
  3942.      programs after the application has polled the keyboard 'n' times during
  3943.      a single clock tick.  Experimentation with this option may allow DESQview
  3944.      to run more smoothly in some cases where an application polls the keyboard
  3945.      waiting for input, but in other cases it can be debilitating to the
  3946.      program in question (a case in point is LIST which polls the keyboard
  3947.      while doing string searches).
  3948.  
  3949.      %-      Starts the application in the background (Your DESQview version
  3950.              must be greater than or equal to 2.26).
  3951.  
  3952.      %h      Starts the application 'hidden' (Again DV must be >= 2.26).
  3953.  
  3954.                                    Appendix B:
  3955.                          Files Created and Used by DV Tree
  3956.                          ---------------------------------
  3957.  
  3958.      DVTREE.CNF                   location:  DV Tree directory
  3959.  
  3960.              This is DV Tree's main configuration file, containing such
  3961.      information as file/tree maximum values, global option values, and
  3962.      customized color configuration values.
  3963.  
  3964.  
  3965.      DVTREE_?                     location:  DV Tree directory
  3966.  
  3967.              (where ? is a drive letter specifier).  These files, created one
  3968.      per DOS logical drive, contain directory structure information for the
  3969.      related drive.
  3970.  
  3971.  
  3972.      DVT_MAC0                     location:  DV Tree directory
  3973.  
  3974.              This file contains DESQview Function definitions and codes.
  3975.  
  3976.  
  3977.      DVT_HOT0                     location:  DV Tree directory
  3978.  
  3979.              This file contains drive specifiers and pointers used by DV Tree's
  3980.      Directory Hot-Key feature.
  3981.  
  3982.  
  3983.      PIPE.LST                     location:  DV Tree directory
  3984.  
  3985.              This file is created when a DESQview Function code string contains
  3986.      the %@ directive to create a list of marked files to be processed by the
  3987.      target application.  DV Tree will never delete this file, but it will
  3988.      reuse it.
  3989.  
  3990.  
  3991.      DVTREE.DAT                   location:  The 'customized' directory
  3992.  
  3993.              DVTREE.DAT files are produced by the Directory Customization
  3994.      feature as required and stored in the customized directories themselves.
  3995.  
  3996.  
  3997.  
  3998.                                 Appendix C:
  3999.                      Error Messages Produced by DV Tree
  4000.                      ----------------------------------
  4001.  
  4002.      This appendix details some DV Tree error messages for which further
  4003.      information than that provided in the text may be helpful:
  4004.  
  4005.  
  4006.      "File error - Disk Full or DV Tree path invalid?"
  4007.  
  4008.              An error has occurred during an attempt to write a file.  This
  4009.      message can occur if the 'TREE=' directory specified on the command line
  4010.      or through an environment variable does not actually exist.
  4011.  
  4012.  
  4013.      "Invalid Command on Directory"
  4014.  
  4015.              'Normal' file management commands such as (C)opy may not be used
  4016.      on a directory entry in the file display.
  4017.  
  4018.  
  4019.      "Current Path too long!"
  4020.  
  4021.              DV Tree will not manage directories with full DOS paths exceeding
  4022.      51 character positions in length.  This is mainly due to DESQview's own
  4023.      limitation of 63 character maximums in the Parameters and Directory fields
  4024.      of PIF files.  Unnecessarily long DOS pathnames are not generally
  4025.      recommended with DV Tree anyway, since they can radically increase the
  4026.      amount of System Memory required to display the tree window.
  4027.  
  4028.  
  4029.      "%....  - Invalid code(s) in string!"
  4030.  
  4031.              During an attempt to define or execute a DESQview Function, DV
  4032.      Tree has detected an invalid DESQview Function code.  This message is
  4033.      prefixed with the portion of the code that begins with the invalid code
  4034.      (valid codes are documented in Appendix A.)
  4035.  
  4036.  
  4037.      "%....  - String expansion too long here!";
  4038.  
  4039.              This message usually means that the expansion of the code string
  4040.      would exceed the maximum length of the Parameters: field in a DESQview
  4041.      PIF, and the usual cause is an 'involved' command line with the %p code
  4042.      expanding into a long DOS pathname.  In this situation, a good way around
  4043.      the problem might be to replace the %p code with %s%D.  This message
  4044.      begins with the code that actually produced the error.
  4045.  
  4046.  
  4047.      "Max Files reached - Hit ESC"
  4048.  
  4049.              The number of files in the directory (or found with the (F)ind
  4050.      command) exceeds the maximum number of files set in the program
  4051.  
  4052.  
  4053.  
  4054.                                  page -70-
  4055.  
  4056.      configuration (or by the FMAX= command line parameter.)  DV Tree will
  4057.      continue operations normally, but the file list will be not be complete.
  4058.  
  4059.  
  4060.      "DV start error - Not enough memory?"
  4061.  
  4062.              This message occurs when DV Tree fails (for whatever reason) to
  4063.      initiate a DESQview Application via an F-Key.  This message can be caused
  4064.      by DESQview's memory being 'fragmented' by non-swappable programs such as
  4065.      communications applications.  (In such a situation, attempts to use
  4066.      DESQview's Open Menu to start the application should also fail.)
  4067.  
  4068.  
  4069.      "Unable to swap in Active copy"
  4070.  
  4071.              In attempting to execute a DESQview Function, DV Tree has failed
  4072.      to "swap in" a running DESQview application that is "swapped to disk".
  4073.      This could mean either that a non-swappable application is in the way of
  4074.      the target application, or that DV Tree itself is in the way.
  4075.  
  4076.  
  4077.      "Assigned PIF not found!"
  4078.  
  4079.              In attempting to execute a DESQview Function, DV Tree could not
  4080.      find the ??-PIF.DVP related to the DESQview Application's Open Keys.  This
  4081.      could mean either that the PIF has been deleted (via Delete a Program), or
  4082.      that the .DVP directory in DV Tree's configuration is invalid.
  4083.  
  4084.  
  4085.      "Nobody under top-left corner!"
  4086.  
  4087.              A command, such as (P)rint or @ESC, was issued to pertain to the
  4088.      'underlying' application, but DV Tree could not find another window
  4089.      beneath it.
  4090.  
  4091.  
  4092.      "Changes to file/tree max require restart."
  4093.  
  4094.              Changes to file max or tree maximum values will not take effect
  4095.      until you (Q)uit DV Tree and restart the program.
  4096.  
  4097.  
  4098.  
  4099.                                     Appendix D:
  4100.                              Script Ideas for DV Tree
  4101.                          ----------------------------------
  4102.  
  4103.  
  4104.           This appendix contains DESQview scripts in text format that you might
  4105.      find useful for use with DV Tree.  To use these scripts, you will either
  4106.      have to 'Learn' them yourself, or extract the statements from this text
  4107.      and use DESQview's CONVSCR program to convert them to binary format.  See
  4108.      your DESQview manual for more information on the CONVSCR program.
  4109.  
  4110.           If you use scripts, you may also find something of value in the
  4111.      DVSCRIP1.ZIP archive distributed with DV Tree.
  4112.  
  4113.  
  4114.      A Script to assign ]-F (flip horz/vert) to alt-]:
  4115.  
  4116.      {Learn {Alt-[} "Flip Split Mode"}
  4117.      [f
  4118.      {Finish}
  4119.  
  4120.  
  4121.      A Script to quickly sort the file list by alpha ascending:
  4122.  
  4123.      {Learn {F11} "Sort Name"}
  4124.      snn
  4125.      {Finish}
  4126.  
  4127.  
  4128.      A Script to quickly sort the file list by date/time descending:
  4129.  
  4130.      {Learn {F12} "Sort Time Descend"}
  4131.      sdy
  4132.      {Finish}
  4133.  
  4134.  
  4135.      A Script to quickly sort the file list by extension ascending,
  4136.      then name ascending within the extension:
  4137.  
  4138.      {Learn {Alt-X} "Sort Extension"}
  4139.      {Alt-S}ennn
  4140.      {Finish}
  4141.  
  4142.  
  4143.      A Script to quickly get back to an unsorted display:
  4144.  
  4145.      {Learn {Alt-U} "Unsorted display"}
  4146.      su
  4147.      {Finish}
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.                                  page -72-
  4154.  
  4155.      A 'Move' script that answers the confirmation for you:
  4156.  
  4157.      {Learn {Alt-M} "Quick Move"}
  4158.      my
  4159.      {Finish}
  4160.  
  4161.  
  4162.      A 'Klip' script that answers the confirmation for you:
  4163.  
  4164.      {Learn {^K} "Quick Klip"}
  4165.      k{Enter}
  4166.      {Finish}
  4167.  
  4168.  
  4169.      A main DESQview script to give you a quick way to open DV Tree:
  4170.  
  4171.      {Learn {Ins} "Start DVTree"}
  4172.      otl
  4173.      {Finish}
  4174.  
  4175.      Note:  The above script should be learned with DESQ menu visible.  Once
  4176.      you've learned it, the INS key on the numeric keypad will bring up DV Tree
  4177.      anytime you have the DESQ menu up (assuming Num Lock is off.)
  4178.  
  4179.  
  4180.      A 'Delete entire directory' script:
  4181.  
  4182.      {Learn {Alt-D} "Delete Whole Dir"}
  4183.      {Enter}
  4184.      k*{Enter}
  4185.      d{Fixed-Pause 1}t{CursorPad Up}{Enter}
  4186.      t{CursorPad Down}d{Fixed-Pause 1}
  4187.      {Finish}
  4188.  
  4189.      Note: If you start the above script while pointing at a directory in the
  4190.      tree, the script will proceed to delete all files in the directory, switch
  4191.      back to the tree, make the directory just above it the current directory,
  4192.      then bring back the tree and delete the (original) pointed-at directory.
  4193.      It is highly recommended that if you use this script you keep the
  4194.      fixed-pauses in the script to give yourself an option to say 'N'.
  4195.  
  4196.  
  4197.      A 'ZIP entire directory' script:
  4198.  
  4199.      {Learn {Alt-Z} "Zip Whole Dir"}
  4200.      k*{Enter}
  4201.      {F6}
  4202.      {Finish}
  4203.  
  4204.      Note: You don't need this example unless you are using the %@ code for
  4205.      PKZIP.  Also, be sure to change F6 in the example to your ZIP F-Key.
  4206.  
  4207.  
  4208.  
  4209.  
  4210.                                  page -73-
  4211.  
  4212.  
  4213.      A script that uses DV Tree's clone, command history, and file jump
  4214.      capabilities to 'imitate' a copy with rename:
  4215.  
  4216.      {Learn {Alt-R} "Copy w/Rename"}
  4217.      {Alt-C}c{Variable-Pause}{Enter}
  4218.      u={CursorPad Down}{Enter}
  4219.      my
  4220.      {Finish}
  4221.  
  4222.      Note: You'll probably need to use the NOHOP command line option for the
  4223.      above to work dependably.
  4224.  
  4225.  
  4226.      A useful script if you like running DV Tree in a small window (as in the
  4227.      TZ version of the PIF), but would rather bring DV Tree up full screen,
  4228.      but still have DESQview Zoom for getting quickly back to the smaller
  4229.      screen.
  4230.  
  4231.      {Learn {250} "!Zoom on Startup"}
  4232.      {DESQ}z
  4233.      {Finish}
  4234.  
  4235.